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PREFACE 


This publication provides the information necessary to define and 

generate the X.25 NCP Packet Switching Interface (X25NPSI) Release 1, 
which runs with the same operating systems as the prerequisite NCP on 
which it is installed-that is, DOS/VSE, OS/VS1, OS/VS2 (MVS), or MVSE. 


X25NPSI is built on ACF/NCP/VS Version 1 Release 2.1 and, as such, 
operates with ACF/VTAM Version 1 Releases 2 and 3 and with ACF/TCAM 
Version 2 Release 3 access methods. 


X25NPSI runs on both IBM 3705-II and 3705-80 Communications 
Controllers. It is a Program Product that enables the users of IBM's 
ACF/NCP Program Products to attach IBM 3705-II or 3705-80 
Communications Controllers to data transmission services which support 
interfaces that comply with CCITT X.25 recommendations. 


This publication is directed so system analysts and system programmers 
responsible for preparing an ACF/NCP/VS and X25NPSI system to be used 
in communicating with an IBM System/370 in which one or more of the 
following access methods are being executed: ACF/TCAM, ACF/VTAM, 
TCAM, and VTAM. 


Note: In this publication, generic terms are used for brevity, as 
follows. Network Control Program (or NCP) refers to ACF/NCP/VS. 
Access Method refers to whichever access method is communicating with 
ACF/NCP/VS, when there is no need to distinguish between TCAM and VTAM 
or between their ACF and non-ACF versions. 


The term network has at least two meanings. A public network is a 
network established and operated by common carriers or 
telecommunication administrations for the specific purpose of 
providing circuit-switched, packet-switched, and leased-circuit 
services to the public. A user application network is a configuration 
of data processing products-such as processors, controllers, and 
terminals-established and operated by users for the purpose of data 
processing or information exchange, which may use transport services 
offered by common carriers or telecommunication administrations. 


Prerequisites and Related Manuals 


Prerequisite to use of this publication is a basic understanding of 
data communications and related access methods. You should also have 
a general knowledge of the purposes of the IBM 3705 Communications 


iii 


Controllers. This knowledge may be obtained from the publications: 
Introduction to the IBM 3704 and 3705 Communications Controllers, 
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GA27-3057; and IBM 3704 and 3705 Communications Controllers Principles 
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of Operation, GC30-3004. 


See the ACF/VTAM Installation and ACF/TCAM Installation manuals for 
VTAM and TCAM information. Also see ACF/NCP/VS NCP System Support 
Programs Installation, SC30-3142. 


Within this publication, mention is made of the following 
publications: 


IBM 5973-L02 Product Description Manual, GA11-8642 (SC 7042) 
ACF /NCP/VS Customization Manual, 2C030- 3146 
ACF /NCP/VS Installation | Release 2.1, 8030-3142 
IBM 5973-L02 Product Description Manual, GA11-8643 (SC 7043) 
IBM Virtual Machine Facility/370: ~ OLTSEP and Error Recording Guide, 
GC20-1809 
¢ OS/VS Environmental Recording Editing and Printing (EREP) Broseam 
Manual, GC28-0772 
e ACF/NCP/VS, Network Control Program, System Support Programs, 
Utilities Manual, SC30-3143 


Program Reference Handbooks refer to: 


¢ IBM 3704 and 3705 Program Reference Handbook, GY30-3012 
°¢ X25NPSI_ Handbook, S$C30-3079 


The NCP Program Logic Manual. refers to: 


¢ IBM 3705 Advanced Communications Function for petwerk Control 


Program/VS Program Logic Manual, SY30-3013 
The Program Logic Manual for this X25NPSI Program Product is: 
° X25NPSI Program Logic Manual, LY30-3053 


The VTAM System Programmer's Guide refers to any of these publications 
as appropriate: 


DOS/VS ACF/VTAM System Programmer s Guide, SC38-0268 
OS/VS ACF/VTAM System Programmers s Guide, S8C38-0258 
DOS/VS VTAM System Programmer ' s Guide, GC27-6957 

OS/VS1 VTAM System Programmer s Guide, GC27-6996 


OS/VS2 MVS System Programmer's Library: VTAM, GC20-0688 
OS/VS SVS System Programmer's Guide, GC27-0049 


The TCAM Programmer's Guide refers to any of the following 
publications as necessary: 
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e OS/VS1 TCAM Programmer's Guide, GC30-2054 
¢ OS/VS2 TCAM Programmer's Guide, GC30-2041 


° OS/VS TCAM System Programmer's Guide, GC30-2051 


Consult your IBM representative for the titles and order numbers of 
related ACF/TCAM/VTAM publications you may need. The Teleprocessing 
Preinstallation Guide for IBM 3704 and 3705 Communications 


Controllers, GC30-3020, may also provide aids to defining your Network 
Control Program. You may also, for the same purpose, use the 
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Communications Controllers, GC30-3021. The Preinstallation Guide 
provides the appropriate values for many of the network configuration 
parameters that must be specified in the control program, and gives 
the value(s) appropriate to each type of station and line set 
accommodated by the program. The Installation Record contains a set 
of formatted sheets representing the communications controller and the 
attached lines, with labeled spaces suitable for recording the 
parameter value appropriate for the network being documented. This 
record should be filled out as soon as the equipment configuration of 
the network is known, and should subsequently be updated each time any 
changes are made to the configuration. | 
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GENERAL DESCRIPTION 


PROGRAMMING SYSTEMS SUPPORTED 


OPERATING SYSTEMS 

The X.25 NCP Packet Switching Interface (X25NPSI) program product 
operates with the same operating systems as the prerequisite NCP on 
which it is installed, that is, DOS/VSE, OS/VS1, OS/VS2 (MVS), and MVSE. 
TP PROGRAMMING SYSTEMS 

X25NPSI is built on ACF/NCP/VS Version 1 Release 2.1 and, as such, 


operates with ACF/VTAM Version 1 Releases 2 and 3 and ACF/TCAM Version 2 
Release 3. 


PRODUCTS SUPPORTED 


COMMUNICATION CONTROLLERS 

X25NPSI runs on both 3705-2 and 3705-80 multiplexors. Attachment to the 
X.25 network requires a full-duplex synchronous adapter (non-switched 
line), and at least one CS2 or CS3 (CS1 is not supported). Only the V24 
(X2lbis) or V35 adapters are supported. 

X.25 NETWORKS SUPPORTED 

The following networks are supported by the X25NPSI: 


° Type 1 Networks 


EURONET Eh eG 
TRANS PAC France 


° Type 2 Networks 


DATAPAC Canada 


DATEX~-P Germany 
NRW Germany 


TERMINAL PRODUCTS SUPPORTED 


e All SNA terminal products connectable to the X.25 networks through 
the IBM 5973-L02 Network Interface Adapter (NIA), specify code 7043. 
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TNL SN30-3213 (26 Feb 82) to SC30-3078-0 


. Non-SNA X.25 DTEs that can be connected to the networks directly 
through the X.25 procedure without using qualified data packets or 
interrupt packets. 


LIMITATIONS ON X.25 FUNCTIONS SUPPORTED 
Access to Datagram services is not allowed. 


Only the X2lbis physical interface is supported (X21 leased is not 
supported). | 


INTRODUCTION TO THE X.25 NETWORK 


This and the following section summarize the X.25 Public Packet 
Switching Network (PPSN) interface characteristics. This information 
should allow you to better understand the functions performed by X25NPSI 
as extensions to ACF/NCP/VS and the SNA access methods (ACF/VTAM and 

ACF /TCAM) . 


Note that this section is not intended to describe all the functions 
performed by the PPSN. Readers desiring more comprehensive descriptions 
should refer to the appropriate documentation. 


THE PUBLIC PACKET SWITCHING NETWORKS (PPSN) 


Public Packet Switching Networks consist of switching nodes and 
internodal high-speed digital communication trunks. Data Terminal 
Equipment (DTE) such as computers, programmable terminal controllers, 
and intelligent terminals may be connected directly to these networks, 
using point-to-point synchronous links and a protocol briefly described 
in this section (see Figure 1-1). 


The fundamental data transport technique used in these networks is 
packet switching. Non-packet switching data services are based upon 
providing a physical data channel as an increment of the dedicated 
bandwidth. This bandwidth may be permanently leased as a non-switched 
line or periodically accessed as a switched offering. Inefficient 
utilization of facilities often occurs because the bandwidth is reserved 
whether data is actually being transmitted. In packet switching, all 
users’ data is formed into discrete variable-length entities called 
packets. In addition to the data being transmitted, each packet 
includes a header. The header specifies control functions and 
addressing information to make sure that the data is delivered to the 
appropriate destinations. Packets of data from many users are 
dynamically interleaved over shared network transmission facilities, and 
routed to their destinations. 


iaZ 


POINT-TO-POINT 
SYNCHRONOUS CIRCUITS 
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Figure 1-1. Network Configuration 
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NETWORK PROTOCOL 


A protocol is a formal set of conventions governing the format and 
control of data in input and output. It gives the data user access to a 
communications network. | : 


The CCITT X.25 protocol is designed for interface on a network providing 
packet switching services. 


It consists of three distinct levels of control procedures: 
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The physical interface 
The frame-level logical interface 


The packet-level logical interface 


The physical interface protocol is concerned with the control of 
each link (four-wire, point-to-point, synchronous) during its 
physical operation. It specifies: the use of the physical interface 
between the DTEs and the network. 


The Frame-Level Logical Interface protocol deals with the logical 
data exchange over each link (format of data, first level of 
recovery procedures). 


It is specified as a subset of the High Level Data Link Control 
(HDLC) procedures being standardized by the International 
Organization for Standardization (ISO). The X.25 protocol is 
symmetrical because each side of the link is equipped with a 
primary and a secondary function. Command frames flow from the 
primary to the secondary function. Response frames flow from the 
secondary to the primary function. 


The frame format includes flags at each end of the frame, and 
header and trailer fields for the identification and checking of 
commands and responses. 


The Frame-Level Protocol ensures that data is accurately exchanged 
between a DTE and the network. 


One frame does not contain more than one packet as defined below. 


The Packet Level Logical Interface (PLLI) protocol specifies the 
manner in which calls are made, maintained, and cleared, and how 
user data and control information are structured into packets for 
presentation to the network. 


The PLLI protocol accommodates both permanent and switched virtual 
circuits. A virtual circuit is a bidirectional association between 
a pair of DTEs over which all data is transferred in the form of 


_ packets. 


A permanent virtual circuit is a permanent association between two 
DTEs, and is similar to a point-to-point non-switched line. 


Some 


: I 


A switched virtual circuit is a temporary association between two 
DTEs. 


A single physical link can support many communications at the same 
time by using an interleaved packet multiplexing scheme. Each 
packet (see Figure 1-2) contains a logical channel number that 
associates the packet with a switched or permanent virtual circuit, 
thus identifying the communication. 


Many functions and facilities are or are not supported, according 
to the type of the virtual circuit. This type is defined, when the 
Prégram Product is installed, as the Logical Link Control Level by 
a specific parameter: LLC=0 or 2. 


LLC level 0 specifies a virtual circuit that communicates with an 
X.25 DTE. LLC level 2 specifies a virtual circuit that 
communicates with an SNA terminal via a 5973-L02 network interface 
adapter. 

of the tasks performed by the X.25 network include: 


dentifying the destination of each packet; 


° Routing each packet accordingly; 


. C 


hecking the accuracy of the packet as it moves along the network; 


° Delivering the packet to its destination in the required format. 


hoot Mies ce wa [ete ig aye AO ee On oas eek a 
| | Frame | | Frame | 
|Flag| Level | | Check | Frame 
| [Control | |Sequence | 
Lipa daria rearereaveeeverueda. | sel een ta ea cca eel ae | po eee ees es J 
| | 
| | 
| | Packet 
|Packet |User Data| 
|Header | | 
Ie Aen re gre ene ep 2 


L-Includes the logical channel number 


Figure 1-2. Packet Format 
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X.25 NETWORK CONNECTION DESCRIPTION 


CONFIGURATION DESCRIPTION 


The SNA components see the PPSN as a telephone line network, each 
virtual circuit being seen as a switched or non-switched line (see 
Figure 2-1). The description of a TP configuration using PPSN is, 
therefore, similar to that of a TP configuration using telephone lines. 
The same macro instructions are to be coded in the same order, but 
several new parameters are included in the NCP generation deck. 


Figure 2-1 (Parts 1 and 2) show how the standard SNA components see a 
connection to the PPSN. 


Figure 2-1 (Part 1) shows the actual configuration: 
° A full-duplex multichannel link is used to communicate with the PPSN 


e A switched virtual circuit (VCl) is established between the 3705 and 
the SNA TER1 terminal 


° A permanent virtual circuit (VC2) is established between the 3705 
and the SNA TER2 terminal. 


Figure 2-1 (Part 2) shows how the SNA components see the above 
configuration: 


° The multichannel link is seen as a non-switched SDLC full-duplex 
link. 


° The switched virtual circuit (VCl) to the TER1 terminal is seen as a 
switched SDLC link 


. The permanent virtual circuit (VC2) to the TER2 terminal is seen as 
a non-switched SDLC link. 


X25NPSI Program Description and Operation Manual 2-1 


| TERI 
{| TER2 


r~ <-> ams ee | 
r= | 
es Aa 
= = | 
« .S) « 7] 
wn = ~” @)} 
z= a 
- J 
= —_ = = on 
; « 
ce 
N & 
e& 
= 
ae 1 | 
Bef ze | 
a | 
{ i «a oa a= =a om oe aw 
|<----—| =_— er a= oP =e a oP 
' 
i] ( 
om aa oo ap ohe oe ow oo oe ow hp © @& oe & OF @ 
Qa Ou Wi mm 
paseo i oo ow oF ao ow eS Ss Sw & 
{ 

‘ ) ' 

! ] wn 
te 
=) 

= ( ] ' a) 
= ' ‘ if 1 H+ 
> YU 

ein { 

i 4 

maar ae SE ape au ae ale oe oe ow ow oe y 
| “\He cot £m = & 
wy 
g| 
~ 
tsa | As nN = J 
re : 
Oo z 
[ =z nn 
< 
WY 
— G]ououen wn ZB Vvwyvy GeO 
So 4 
~ © 2) 
~ aa! oO 
“‘ e w= 
” 4 6&4 
| Y fo a} 
| Lt] 
~~ & 
{ an z 
Au oa 
< 
——_——_—_——_ —e oe a oe ee oe oe ew ee Se ow ae 


kis INTERFACE 


Actual Physical Configuration 


Figure 2-1 (1 of 2). 
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Configuration as Seen by SNA Components 


Figure 2-1 (2 of 2). 
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Multiline Protocol 


The X25NPSI does not support the multiline protocol. 


Flow Control Parameters 


PACKET AND WINDOW SIZE: The X25NPSI supports the optional "Packet and 
Window Size Selection per Virtual Circuit" mechanism. 


Therefore, for each Virtual Circuit, you have to associate an entry in 
the Virtual Circuit Parameter Table (VCCPT), where are defined a packet 
length and a window size, that will apply to the virtual circuit (the 
MAXPKTL and VWINDOW parameters of the X25VCCPT macro instruction). The 
association between a VC and an entry in the VCCPT is done at generation 
time for a permanent VC and a switched VC (CALL-IN), and at connection 
establishment for a switched VC (CALL-OUT only). 


For a connection to an SNA terminal via the 5973-L0O2 NIA, the SNA 
segmentation is transparent to the X25NPSI. The "more data bit" 
mechanism -- that is, the X.25 segmenting, is not supported. 
Segmentation is performed using the Segment Indication of the FID-FOX, 
which is the LLC Header for LLC level 2, to adapt a PIU to the packet 
length used for the X.25 connection. Type 1 networks allow different 
packet lengths, and you can choose one of them with the MAXPKTL operand 
of the X25VCCPT macro instruction. 


Note: What is sent from the 3705 must be able to enter the 5973-L02 
without the "more data bit'’ mechanism, and vice versa. Thus, the 
5973-LO2 must be defined with a packet length equal to that of the 
current connection in the 3705. 


For a connection to an X.25 product, since the Protocol Converter for 
Non-SNA Equipment (PCNE) uses the "more data bit'' mechanism, you may 
specify any valid "MAXPKTL="" value corresponding to your subscription. 
For the VWINDOW parameter, it is recommended that you use 2, but you may 
- specify any value within the limits imposed by the network to which the 
3705 is being connected. 


If you have a multichannel link containing some virtual circuits that 
communicate with 5973-L02 adapters and other circuits that communicate 
with non-SNA X.25 DTEs, you may choose any combination of 'MAXPKTL="' and 
"VWINDOW="" values corresponding to your subscription. 


THE THROUGHPUT CLASS: With respect to the throughput class, a virtual 
circuit is characterized by two types of data flow for which the | 
receiving capacity of one end must equal the sending capacity of the 
other end. A particular capacity does not imply particular packet 
length and window values. The throughput class is a pricing parameter. 
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FLOW -2 | FLOW 1 


Flow 1 is defined by the throughput class for transmission from the 
calling DTE. 


Flow 2 is defined by the throughput class for transmission from 
the called DTE. 7 


For switched virtual circuits, if there is a conflict between the 

throughput classes for the transmission indicated in the CALL REQUEST packet 
and the default throughput classes for the reception 

of the corresponding DTEs, the lowest throughput class value 

is forced by the network for each flow. 


The throughput class mechanism is proper to the network, and the 
X25NPSI or the 5973-L02 are not involved in this mechanism except 

in the case of switched virtual circuits, as far 

as the "Selection by the calling DTE of 

the Throughput Classes per Communication" is concerned, as shown in the 
following table. 


Fe ee a ee ge Se ee ee ee ee eee [iret Wy ok 


| FACILITY |X25NPSI 15973- 102 | 
re eg ge eg gS ER ne FS a ee ee | Sad eet doses | itt id fn J 
| Choice of the default throughput classes of | NOT | NOT | 
| the link for each virtual circuit. PN ORVEDLTNVOLVED! 
La a i a ae Sak ls a a a aa an a ea an at al a a a a | as eal as oa eae | ee 
| Selection by the calling DTE of the | | | | 
| throughput classes per communication. |Note 1 |Note 2 | 
pee pe ed ee pee Om en ee aE eee NE te Rey eee eee [eavseece | -------- J 
| Throughput class indication to the called ~ |NOT | NOT | 
| DTE. | | INVOLVED | INVOLVED | 
Cs a i i laa a a cea Ba ae a me ee ca ee eae ea al a ee re ere ee 
| Choice of the throughput classes per | NOT | NOT | 
| permanent virtual errcuit. pEVORVEP  TNVOEYED 
Uc a eat csc doy aha alles ace Geile mea ia cet Ela et, ites, a hs Sag Sl aa ra Serhan 
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Note 1: 

This facility is supported by the X25NPSI via the "OPTFACL=" operand of the 
X250UFT macro instruction, as described below in the X.25 Stage 1 Generation 
Macro Description. 


The coding for the facility code and parameter fields for the throughput 
classes in the CALL REQUEST packet is: 


Facility Code Field = X'02' 
Facility Parameter Field = bits: 0123 4567 


The throughput class for transmission from the calling DTE is indicated 
in bits 4, 5, 6, and 7. The throughput class for transmission from the 
called DTE is indicated in bits 0, 1, 2, and 3. Bits 3 and 7 are the 
low order bits of each throughput class indicator. 


Note 2: For more information, refer to the 5973-L02 Product Description 
Manual, GA11-8632. 


Reject Option 


This option, which allows a DTE to request the retransmission of one or 
several consecutive DATA packets from the DCE by using the REJ packet, 
is not supported either by the X25NPSI or by the 5973-L02. 


Acceptance of Reverse Charging Calls — 


This option is not checked either by the X25NPSI or by the 5973-L02 when 
receiving an INCOMING CALL packet. However, you may ask for this 
option. In this case, the caller's decision is always accepted as far 
as charging is concerned. 


The reverse charging request is provided by the X25NPSI via the 
"OPTFACL=" operand of the X250UFT macro instruction. 


The coding for the facility code and parameter fields for reverse 
charging in the CALL REQUEST packet is: 


Facility Code Field = X'01' 
Facility Parameter Field = X‘00' (Reverse charging not requested) 
X'O1' (Reverse charging requested) 


Closed User Group 


This option, which allows a specific group of users to communicate with 
each other but not with any user outside the group, may be used but is 
not checked by the X25NPSI; see the "OPTFACL="" operand of the X250UFT 
macro. 
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SUPPORT OF TYPE 2 NETWORKS 


What has been explained above for Type 1 Networks also applies to Type 2 
Networks. Moreover, for Type 2 Networks, you have to consider the 
following options. 


High-Priority Class of Traffic 


This option is granted for a period of time to a given permanent virtual 
circuit, or requested by a DTE for a given switched virtual circuit. 


It is supported for outgoing and incoming calls and must use packets 128 
bytes long. For incoming calls, the X25NPSI checks for high-priority 
service requests in the facility fields and internally updates the 
maximum packet size for the duration of the call. For outgoing calls, 
the X25NPSI supports this facility by using the "OPTFACL=" operand of 
the X250UFT macro instruction associated with a VCCPT entry containing a 
"MAXPKTL="" parameter coded with a value of 128. Refer to the "X.25 
Stage 1 Generation Macro Description" section of this manual. 7 


This support has no impact on the internal scheduling of the NCP. 
Facility Code = X'01' | 
Facility Parameter Field = X'00' (Facility not. requested) 
X'02' (Facility requested) 


Note: The 5973-L02 NIA also supports this facility. Even if it is | 
configured with a maximum packet length of 256, the 5973-L02 dynamically 
changes this value to 128 when this facility is specified in a CALL : 
REQUEST or INCOMING CALL packet. 


The One-Way Logical Channel Facility 


This user facility limits the use of a logical channel to either 
incoming or outgoing calls. The switched logical channels are seen by 
the SNA access method and the NCP as switched SDLC lines. By means of 
the "CALL="" parameter of the: 

¢ VTAM "LINE" macro instruction, and of the 

¢ TCAM "TERMINAL TERM=LINE" macro instruction. 


the use of a switched logical channel can be reserved for a one-way call 
only. : 


Special Considerations for Nord Rhein Westfalen Facilities 


Only X.25 DTEs working in LLC level 0 can be connected to this network. 
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X25NPSI DESCRIPTION 


The X.25 NCP Packet Switching Interface is included in ACF/NCP/VS using 
the Customization facility described in the ACF/NCP/VS Customization 
manual, ZC30-3146. It contains specific control blocks (SSP extension), 
and seven main modules (NCP extension): 


1. 


Ts 


The Initialization Routine, running at level 1, to initialize the 
X25NPSI control blocks. 


The Network Action Scheduler (NAS), which provides the interface 
between the NCP and the X25NPSI by giving control to the 
appropriate X25NPSI module. 


The Logical Link Control (LLC) routine, which deals with the 
end-to-end transmission control over a permanent or switched 
virtual circuit. 


Two types of LLC are included in the X25NPSI: 


e LLC level 0, as implemented by the SNA/X.25 Protocol Converter 
(PCNE). LLC level O deals with the transmission of data 
between SNA applications and non-SNA X.25 DTEs (terminal, 
cluster, host) over a virtual circuit. 


° LLC level 2, as implementrd by the Physical Services Header 
(PSH) routine. LLC level 2 deals with the transmission of data 
between the X25NPSI and the NIA to which SNA devices are 
attached. 


The Virtual Circuit Manager (VCM), which deals with the activation 
and deactivation of virtual circuits. 


The Packet Level Procedure (PLP), which controls packet 
transmission over the virtual circuits. 


The Line Access Control (LAC), which manages the physical link(s) 
between the 3705 and the K.25 DCE node. The prime function of the 
LAC is to control the actual transmission of data between the 3705 
and the X.25 DCE to which it is attached. The LAC supports both 
communication scanners type 2 and type 3. | 


The Link Level 2 Test for virtual circuits (LL2T/VC). 


Figure 3-1 shows the X25NPSI data flow. 
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Figure 3-1. X25NPSI Release 1 Data Flow 
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X25NPSI MODULES 


INITIALIZATION ROUTINE 


After loading the NCP into the controller, the loader program passes 
control to the system initialization procedure, which: 


sd Initializes the communication lines 

ad Initializes the channel adapters 

e Formats the buffer pool 

° Initializes the storage protection mechanisms 


e Initializes the NCP control blocks that require dynamic 
initialization. 


After this standard system initialization, the X25NPSI adds processing 
in order to: 


e Initialize pointers from the X25NPSI blocks to the standard NCP 
blocks 


e Initialize values in the X25NPSI blocks that cannot be set during 
NCP generation -- mainly input data offset, slowdown thresholds, and 
cutoff values. 3 

e Check the compatibility between the NCP network definition and the 
X25NPSI network definition. 


NETWORK ACTION SCHEDULER (NAS) 


The NAS gets control from the NCP via the Customization facility in the 
following cases: 


° Each 100 milliseconds to scan the SCBs for Contact, Discontact, or 
XID 


: Each time an XIO is performed by the BNN or the Physical Services 
and each time a line timer elapses for an X.25 resource 


e Each time a level 2 or level 3 Interrupt occurs for an X.25 line. 


NAS Entered by Timer Tick (Every 100 milliseconds) 


The SCBs are scanned periodically for Contact, Discontact, or XID: 
° For an MCH, control is given to the LAP by a branch. 


e For a VC, the LLC-OUT is triggered. 
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XIO or Line Timer 


In the case of an MCH: 


e For 


© For 


XIO LINE, control is given to the LAP. 


XIO IMMEDIATE, control is given to the LAP. — 


e For XIO SETMODE, the NAS itself handles the command and processes it 
if OK. | | | 


| e For 


e For 


XIO LINK, the NAS sends a negative response to the host. 


Line Timeout, the NAS gives control to the LAP. 


In the case of a VC: 


° For XIO LINE, the VCM-OUT is triggered. 


For XIO IMMEDIATE, branch to a VCM routine for action. 


e The XIO SETMODE is handled in the NAS, this XIO SETMODE is mainly 
used to perform operations at level 3 from level 5. | | | 


e For 


XIO LINK, the NAS enqueues the PIU to the LLC-OUT QCB and 


triggers this QCB. 


e Line Timeout is not used. 


Level 2 and Level 3 Interrupts 


These interrupts cannot occur for a VC. 


In the case of an MCH: 


e For 
the 


e For 
the 


LOGICAL 


a level 2 interrupt, locate the UACB and branch to an entry of 
LAP acccrding to the status: 


No error: The LAP entry address is in MUAL2. 

Error: The LAP entry address is contained in MUAL2 minus 2. 
Modem check: Predefined LAP entry. 

a level 3 interrupt, branch.to the address contained in MUAL3 in 


UACB of the line. 


LINK CONTROL (LLC) ROUTINE 


Over a virtual circuit, the LLC plays the same part as the Synchronous 
Data Link Control for an SDLC line (see Figure 3-2). The LLC performs 
two functions: 
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1. Controls the virtual circuit SNA status, and 
2. Performs the data transmission integrity check. 


For a virtual circuit communicating with a non-SNA X.25 DTE (LLC level 
0), the LLC gives control to the PCNE module. 


For a virtual circuit communicating with a 5973-L02 NIA (LLC level 2), 
the LLC gives control to the PSH module. 


The unit of data transferred over a virtual circuit by the LLC is called 
a Logical Link Unit (LLU). Its format is illustrated in Figure 3-3. 

For LLC level 0, the format of the LLU is the same as that of the RU. 
For LLC level 2, the LLU consists of a PIU preceded by a 2-byte header. 


From a coding point of view, the LLC is divided in two parts: 
1. LLC-OUT for outbound LLU processing is invoked by the NAS (in the 
case of XIO LINK), or by the BNN-PC-OUT (in the case of TEST, XID, 
SNRM or DISC). | 


2. LLC-IN for inbound LLU processing is a level 5 routine that is 
always invoked by the PLP-IN. 
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The 
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Figure 3-2. The Logical Link Control (LLC) 
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Figure 3-3. Format of the LLU 


LLC level 2 header is the FID-FOX. 


IBM Terminal 


- Protocol Converter for Non-SNA Equipment (PCNE) 


The PCNE is a subroutine called by the LLC dispatcher when processing 
virtual circuits working in LLC level 0. 


The PCNE allows communications between an application using an SNA 
access method and non-SNA X.25 DTEs (terminal, cluster, or host). 


The protocol conversion is performed only between the X.25 packet header 
(or some X.25 control packets) and the transmission/request header of 
the SNA PIUs. The data contained in the SNA FM request units, or in the 
data packets, is not processed by the PCNE and is transferred end-to-end 
without any conversion. 


The handling of the TH and RH by the PCNE is similar to that of the 3767 
secondary LU. Only one LU can be associated with a PU -- that is, on 
the X.25 side, only one PU/LU pair appearance can be associated with one 
virtual circuit either permanent or switched. 


In order to write an SNA application working with the PCNE, you need to 
know much more about the internal processing of this module. To obtain 
the required information, please refer to the section of this manual 
titled "Communicating with non-SNA X.25 DTEs." 


Physical Services Header (PSH) Module 


The PSH is a routine invoked by the LLC Dispatcher when processing 
virtual circuits working in LLC level 2. The PSH allows communications 
between an application using an SNA access method and an SNA terminal 
connected to the X.25 network via a 5973-L02 NIA. 
The PSH performs the following functions: 

1. Control of the Virtual Circuit's SNA Status: 


The PSH works in asynchronous response mode. 


Because there are supervisory (S) frames in the SDLC procedure, the 
PSH supports the following supervisory LLUs: 


PSCONT 


SNRM = 

XID = PSXID 
DISC = PSDISC 
TEST = PSTEST 


NSA is not used, the answer to a command being the command itself. 


2. Control and integrity verification of data by sequencing each 
output I-LLU: 


If a sequencing error occurs during reception, the virtual circuit 
is cleared. The segmenting of a PIU into several I-LLUs (adapted 
to packet size) is provided by the segmenting function of the 
PSH-OUT. The control of the outbound and inbound I-LLU flow is 
provided by the pacing function. However, before calling the 
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PLP-OUT to transmit an LLU, the LLC must make sure that the PLP-OUT 
can transmit this LLU. This means that the packet window is not 
closed, and that the PLP has not received an RNR packet. In other 
words, the queuing of data is performed at LLC level. 


VIRTUAL CIRCUIT MANAGER (VCM) 


The Virtual Circuit Manager is that part of the X25NPSI that supervises 
the virtual circuits. The VCM controls the enabling and disabling of 
permanent and switched virtual circuits. It makes and breaks 
connections with remote data terminals over switched virtual circuits. 


The virtual circuits are supervised via commands from the System 
Services Control Point (SSCP), or via control packets received from the 
packet network. 


The Virtual Circuit Manager code is divided into three parts: 
1. ‘The VCM-IN Task, for functions common to all VCs. 


2. The Virtual Circuit Manager Out (VCM-OUT), which receives SSCP 
commands. If the command can be performed, it is sent to the 
packet network in a control packet. 


3. The Virtual Circuit Manager In (VCM-IN), which receives and 
processes the control packets coming from the packet network. 


VCM-IN Task 


The VCM-IN task sends or receives RESTART packets after SABM exchange. 
It breaks the connection for all VCs after DISC exchange, on request 
from the host's operator or from the X.25 network, and in case of MCH 
failure. 


Virtual Circuit Manager-Out (VCM-OUT) 


The VCM-OUT deals with the following SSCP commands: 


ACTIVATE LINK } 
DEACTIVATE LINK } Permanent Virtual Circuit 


CONNECT -OUT } 
ABANDON CONNECT-OUT_ } 
~ CONNECT-IN } Switched Virtual Circuit 
ABANDON CONNECT-IN  } 
ABANDON CONNECTION _ } 


The VCM-OUT replies with a +RSP/-RSP to the SSCP when it does not send 
the command to the packet network (ACTIVATE LINK, CONNECT-IN, ABANDON 
CONNECT-OUT, ABANDON CONNECT-IN). When the SSCP command is sent to the 
packet network in a control packet (DEACTIVATE LINK, CONNECT-OUT, 
ABANDON CONNECTION), the +RSP/-RSP to the SSCP will be sent by VCM-IN at 
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packet network response time. The SSCP command is forwarded to the 
network in a control packet. The result is that: 


e The CONNECT-OUT command produces a call request control packet 
° The DEACTIVATE LINK command produces a reset request control packet 


° The ABANDON CONNECTION command produces a clear request control 
packet. 


Virtual Circuit Manager-In (VCM-IN) 


The VCM-IN receives commands (Control Packet Indications) or responses 
(Control Packet Confirmations) from the packet network. These network 
commands/responses are forwarded to the SSCP in request/response PIU 
format by VCM-IN. The commands processed by VCM-IN are: 


° CONNECTION/DISCONNECTION of a switched virtual circuit 
° DEACTIVATION of a permanent virtual circuit 


° DEACTIVATION of all permanent virtual circuits and DISCONNECTION of 
all switched virtual circuits. 


PACKET LEVEL PROCEDURE (PLP) 


The PLP controls the inbound and outbound packet flow. In order to 
perform these functions, the PLP is divided into: 


¢ The PLP-OUT to handle the flow of outbound packets 


° The PLP-IN to handle the flow of inbound packets. 


Packet Level Processor-Out’ (PLP-OUT) 


PLP-OUT is a routine running at level 5. It is called by LLC-OUT in 
order to edit and queue, in packet format, data to be transmitted by the 
LAC over the multichannel link. PLP-OUT activates the LAC via an X25XIO 
macro instruction. 


PLP-OUT receives an LLU from the LLC-OUT. It adds an information (I) 
packet header consisting of a packet type, virtual circuit number, and 
inbound/outbound sequencing. PLP-OUT regulates this outbound flow in 
accordance to the DTE packet window controlled by the P(R) from the DCE. 
A received RNR stops this outbound flow until RR packets are received 
from the DCE. 


PLP-OUT computes statistic counters for the number of RNR and data 


packets. A statistics PIU is sent to the NCP in case of counter 
overflow. 
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If the VCM detects an inoperative condition for a given virtual circuit, 
PLP-OUT is called to snap the packet traffic situation when the problem 
is detected. 5 


Packet Level Processor-In . (PLP-IN) 


PLP-IN is made up of two modules: The Packet Dispatcher and the PLP-IN 
delayed. 


The packet dispatcher runs at interrupt level 3. This is a routine 
performed by the LAC to route received packets to their proper 
destinations: 


Restart packets to the VCM-IN task, and information (I) and other S 
packets to PLP-IN delayed. 


The processing of RR or RNR packets, and more generally the control of 
the inbound packet flow, is performed in the PLP itself. 


PLP-IN computes statistic counters for the number of RR, RNR, and I 
packets received from the DCE. If a counter overflows, a statistic 
record is sent to the SSCP. 


PLP-IN delayed is activated by the reception of I packets. The LAC 
splits the received packet in two parts within the input buffers. 
Therefore, PLP-IN delayed reformats the I packet in a standard PIU 
before enqueuing it to LLC-IN for later processing. 


LINE ACCESS CONTROL (LAC) 


The purpose of the LAC is to control the status of the multichannel 
link(s), and the transmission of data between the 3705 and the PPSN node 
on the full-duplex link. The functions performed by the LAC can be 
sorted into three major groups: 


1. The common processing related to link status control. 


2. The primary processing in charge of controlling the 3705's primary 
function. 


3. The secondary processing in charge of controlling the 3705's 
secondary function. 


: The common functions are performed when the link is activated, when 
an ACTIVATE LINK command is received by the physical services of the 
NCP, and when the link is deactivated after the physical services 
have received a DEACTIVATE LINK command; or when a permanent 
abnormal situation is detected on the link. Once the common 
function responses are completed, RECMS are generated and sent to 
the host SSCP. | 


° The primary functions control the status of the primary leg of the 
full-duplex link, and the transmission of I frames to the PPSN node. 
If a permanent abnormal situation is detected on the primary leg, 
the common functions are scheduled for the deactivation of the link. 


° The secondary functions control the status of the secondary leg of 
the full-duplex link, and the reception of I frames from the PPSN 
node. If a permanent abnormal situation is detected on the 
secondary leg, the common functions are scheduled for the 
deactivation of the link. 


The LAC interfaces with the packet dispatcher. The LAC delivers the 
received packets and returns transmitted packets to the packet 
dispatcher. 


The LAC operates mainly at machine levels 2 and 3: 


° Actions requiring a direct interface with the scanners are executed 
at level 2. | 


: Transmission initialization and all logical operations are executed 
at level 3. 


The LAC records the activity of the lines by counting the number of 
bytes, I frames, RRs, RNRs, and REJs exchanged. The counters are 
delivered to the access method via statistical RECMS, or via station 
error RECMS, each time a pertinent event occurs for a line (enable, 
disable, MCH failure, counter overflow). 


° The LAP and LAPB protocols are supported. 


LINK LEVEL 2 TEST FOR VIRTUAL CIRCUITS (LL2T/VC) 


This routine causes the same functions to be performed for virtual 
circuits as are performed by the Link Level 2 Test for SDLC links. 


The test is independent of the LLC level. It operates both for SNA 
terminals through NIA, and for non-SNA X.25 DTEs able to echo received 
data. 


In order to avoid packet segmenting, test data received from the host is 
truncated to the maximum packet length. 


Please refer to the ACF/VTAM documentation for details concerning the 
Link Level 2 Test mode of operation. 

CONTROL BLOCKS 

This section presents the new control blocks prepared by the X.25 


generation and created at NCP generation time, and shows the 
relationship between them and NCP blocks. 
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BLOCKS INITIALIZED BY THE CUSTOMIZATION FACILITY 


NCP Control Blocks (LNVT/ULVT/UACB) 


Figure 3-4 shows the relationship between these control blocks. 
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Figure 3-4. NCP Control Block Relationship 
Note 1: All the UACBs (MCHs or VCs) have a pointer to their own GCB and 
to an LKB. 


Note 2: MCHs, PVCs, and SVCs each make up a separate group having its 
own GCB: (GCB-MCH, GCB-SVC, GCB-PVC). 
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Note 3: The BAR-VECTOR field (CCBBAR) of the VC's UACBs contain 
X'0000'. This serves to identify them. 


X25NPSI BLOCKS 


Figure 3-5 shows the relationship between these control blocks, and 
Figure 3-6 shows the relationship between these and NCP control blocks. 


Blocks Initialized by the X25BUILD Macro Processor 


Two types of block are initialized by the X25BUILD macro processor. 


1. The Address Vector Table (AVT) is 28 bytes long. It contains a 
pointer to the Multi Channel Address Table (MKBAT). 


2. The MCH Address Table (MKBAT) consists of twelve-byte entries that 
contain a pointer to each Multichannel Block (MKB) and counters for 
the NAS scanning routine. An entry is reserved for each subsequent 
X25MCH macro. 


Blocks Initialized by the X25NET Macro Processor 


The X25NET macro reserves space for the Virtual Circuit Parameter Index 
Table (VCCPTIT) and the User's Facility and Data Index Table (OUFTIT). 


Blocks Initialized by the X25VCCPT Macro Processor 


The X25VCCPT macro initializes one Virtual Circuit Parameter Table 
(VCCPT) and the corresponding entry in the VCCPTIT. 


Blocks Initialized by the X250UFT Macro Processor 


The X250UFT macro initializes the User's Facility and Data Table (OUFT) 
and the corresponding entry in the OUFTIT. 


Blocks Initialized by the X25MCH Macro Processor 


The X25MCH processor for a multichannel link initializes four types of 
blocks: The User Adapter Control Blocks (UACBs), the Multichannel Block 
(MKB), the Virtual Circuit Group Address Table (VCGAT), the Virtual 
Circuit Block Address Table (VCBAT). 


° The Receive and Transmit UACB contains mainly the interface with the 
NCP and plays the same part as the ACBs do for a standard SDLC line. 


e The Multichannel Block (MKB) contains all the characteristics of the 


multichannel links given by the X25MCH macro parameters, and 
pointers to the NCP and related X25NPSI blocks. | 
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e The Virtual Circuit Group Address Table (VCGAT) contains pointers 
for all defined Logical Channel Groups to the entry in the VCBAT 
corresponding to Logical Channel Number zero, even if it is not 
defined. Each entry in the VCGAT is eight bytes. 


¢ The Virtual Circuit Block Address Table (VCBAT) contains pointers | 
for all defined Logical channel Numbers to the corresponding Virtual 


Circuit Block (VCB) and CUB. Each entry in the VCBAT is twelve 
bytes. 


Block Initialized by the X25LCG macro 


The X25LCG macro initializes an entry in the VCGAT. 


Blocks Initialized by the X25VC Macro Processor 

A Virtual Circuit Block (VCB) is created for each permanent or switched 
virtual circuit by the X25VC macro. The VCB is initialized with the 
following information: | 

° Type of virtual circuit 

e Number of the virtual circuit 

° Pointer to the MKB. 


A User Adapter Control Block (UACB) is created for each virtual circuit. 


A Secondary Logical Unit Block (SLUB) is created when the line has been 
defined with LLC=PCNEO (LLC level 0). 
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Figure 3-5. X25NPSI Control Block Relationship 
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Figure 3-6. NCP and X25NPSI Control Block Relationship 
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Note: The ====> between the X.25 and NCP control blocks are established 
at INITIALIZATION time; the others are established at sysgen time. 


RECORD FORMATS 
FRAME FORMAT 
All transmissions over a multichannel link are in frame format. The 


frame format is: 


Porc cp tne ye hl ek wee a ie eee eo ea, Se ia ew Poe fe Ene cl 
| FLAG | ADDRESS | CONTROL| INFORMATION| FRAME CHECKING |FLAG| 


| | | | | SEQUENCE | | 
| F | A ime | I | FCS1 | FCS2 | F | 
See MO REE eee oe Rice, ee ee REET Oe EOE oe ERTS Ry ee eee See Ee en eee MeL ROME ENED | 
0--7 0----- 7 O----- 7 8 xN bits 0----- 7 O----- 7 0--7 


1. Flag: The (F) flag is equal to X'7E' 

2. Address field: 
Commands from the DCE to the DTE contain X'03' 
Responses from the DTE to the DCE contain X'03' 
Commands from the DTE to the DCE contain X'01' 
Responses from the DCE to the DTE contain X'01' 


In other words: 


The address of the X.25 LAC's secondary is X'03, and 
The address of the DCE's secondary is X'01'. 


3. Control field 


This byte contains commands and responses described in the 
following table: 
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fren ae r r 

| | | cayman | 
| FORMAT | COMMANDS | RESPONSES L..--. pee Sess 
| | | |O 1 2| 3 14 5 6 7 | 
Heese [Serena ten ae meee areas [oe eee eens eaten ener [rRees eatnmec cae s 
|Infor-| | | | | | 
|mation| | | | | | 
|trans-| I Information | INCR) | P | NCS) 0] 
[fer | ; | | | | | | 
ee Coe arora |azenee tees tees eee eeece ee |----- |---| 222-27 
|Super-|RR Receive ready | RR Receive ready INCR) |P/FJO 0 0 1| 
|visory|RNR Receive not ready | RNR Receive not ready INCR) |P/FJO 10 1| 
| |REJ Reject | REJ Reject INCR) |P/F]1 0 0 1 
ee eee Seeesueeeese ee [----- |---!------- 
| |SARM Set synchronous | loo Oo] P1111 
| | response mode | | | | 
| | | DM Disconnect mode 10 0 O| F {1 111] 
l | Lfeeteeeecce eueeueleeeceee eee eee eee ee J 
{Non |SABM Set asynchronous | joo1i] Pj11i11{ 
| Sequen | balanced mode | | | | | 
|ced [DISC Disconnect | [oO 1 0] Pjooi1 1 
| | | UA Unnumbered susie Ss) be 11| F jo 0 aie 
| fo be nen ee eee eee -----------l ----- ss a Nal 2a sal ales 
| | | FRMR Frame reject re OoO| F jo 11 1| 
ena Liwee seaweed weaeeee we Leowemeeewcme eto emeeeweeee bewaw ee Gea Goewecuwe 


where: 
N(S) is the Send sequence number 
N(R) is the Receive sequence number 
P/F is the Poll/Final bit 


The use of the above commands/responses is in full conformity 
with CCITT/X.25 recommendations. 


The first bit of each byte sent over the line is bit 7. 
4. Frame Checking Sequence 
The FCS is a 16-bit sequence. It is calculated by using the 


generator polynomial: 
X?& + xX?2 + xX + 1. 


Table of Supported Frames 
1. PSNSTAT = LAP 


ee ee ee eee epee pe erg ohare age ee] 

| SENT BY 3705 | RECOGNIZED BY 3705| 
| FRAMES | Command | Response| Command | Response| 
= | | | | | 
| I @ P) | x | | * | | 
ae ee eee 
| SARM (+ P) | * | | * | | 
| (- P) | | | * | | 
| | | | | | 
| DISC (+ P) | «| | x | | 
| (- P) | | | e | | 
| | | | | | 
| UA (+ F) | | * | | * | 
| (- F) | | * | | | 
| | | | | | 
| FRMR (+ F) | | «| | x | 


| RR (+t F) | 
| | 
| RNR (+ F) | 
| | 
| REJ (+ F) | 
ete eas Oe EPA ERES Meeerrer era RSP ME Ste RES ee Ser eh Nee eters eA ie Cree eee iO aN | 

The + character means "with", that is, +P means with poll bit. 


The - character means "without", that is, -F means without final bit. 
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2. PSNSTAT = LAPB 


[es ee ee Pe al 
| | SENT BY 3705 | RECOGNIZED BY 3705| 
| FRAMES | Command | Response| Command | Response| 
| . ) | , ) | | 
| I (+ P) | . a | “| i | 
i sP) | * | | ey | 


ale 
PAY 


SABM (+ P) 
(=P) 


DISC (+ P) 
(- P) 
(- F) 


DM (+ F) 
(- F) 


| | 
| | 
| | 
| | 
| | 
| | 
| UA (+ F) | 
| | 
| | 
| | 
| FRMR (+ F) | 
| (- F) | 
RR (+ P/F) 

(- P/F) 


7 


| 

| 

NR (+ P/F) | 
(- P/F) : 

REJ (+ P/F) | 
| 


| 
| 
| 
| 
| 
| (- P/F) 


Je | de | 


PACKET P/FORMAT 


The following diagram shows the packet format: 


bit = 0 1 2 3 4 5 6 7 
oe ee ees bese te ee 
|General Format | Logical | | 
byte O | Identifier | Channel Group | | 
| | Number | | 
Cela woe ete eee Leni ww eee eae cele J | 
| | | 
1 | Logical Channel Number | PACKET HEADER 
| | 
In Rg en ie ng oa Ear rg ne ek ee J | 
| | | 
2 | Packet Type Identifier | | 
| | | 
Maa a as a ee areal ee J ' 
| 
3 | Packet Type Dependent Field | 
| 
i siee debate aekiouusdiawamanenanmmeniina 


Each packet is identified by the General Format Identifier (byte 0, bits 
0 to 3) and by the Packet Type Identifier (byte 2). 


The Virtual Circuit Number is made up of the Logical Channel Group 
Number (byte 0, bits 4 to 7) and the Logical Channel Number (byte 1). 


The meaning of the fields starting from byte 3 depends on the type of 
the packet. 


The following table shows all the possible packet formats supported by 
this X25NPSI. 
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| PACKET TYPE IByte 0 |  ~—=—Byte 2 | 
: 3 = bits | bits | 

| FROM DCE TO DTE FROM DTE TO DCE |0 123/0123456/7| 
| CALL SET UP AND CLEARING | | | | 
| Incoming Call Call Request lod0d0 1j/o0001011 
|Call Connected Call Accepted loo0d0 ijo0001111 
|Clear Indication Clear Request looo01jo001001 1] 
|DCE Clear Confirmation DTE Clear Confirmation |0001]/00010111 
I | S$ 
| DATA | | | 
|DCE Data DTE Data IQ00 1]/RRRMSSSO| 
| | -—_—__—___-_—__—__ 
| | FLOW CONTROL AND RESET | | | 
|DCE R | DTE RR loo oO 1{RRROOOO 1] 
|DCE RNR DTE RNR lOoood0 1J/RRROO101 
|Reset Indication Reset Request loo001j/00011011| 
|DCE Reset Confirmation DTE Reset Confirmation |0001]00011111 
|DCE Interrupt DTE Interrupt looo01j/00100011 
|DCE Interrupt Confirm DTE Interrupt Confirm loo001j/0010011 1] 
| RESTART | | | 
|Restart Indication Restart Request loo001/11111011 
(O00 1f11111111] 


|DCE Restart Confirmation DTE Restart Confirmation 
ERE een Re Ree a ree PI ee Me Re renee Rare eae eek en ea a eee A TN SENET! See ee) aS aaa SON eee ee NoPE MELE TTS 


Where: 


Q = Data Qualifier bit (not supported by Release 1 of the X25NPSI) 
M = More Data indication 

RRR = P(R) Packet Receive Sequence Number 

SSS = P(S) Packet Send Sequence Number 


An I packet is a packet which contains a P(S) and P(R) field. 
An S packet is a packet which contains a P(R) field only. 
An NS Packet is a packet which contains neither P(S) nor P(R) fields. 


Note: In a CLEAR REQUEST or a RESET REQUEST packet, byte 3 is called 
the CAUSE byte and is set to X'00', and byte 4 is called the DIAGNOSTIC 
byte and is coded as explained below. DATAPAC does not support the 
diagnostic field in the CLEAR REQUEST packet. This means that, in the 
case of DATAPAC, the X25NPSI sends 4-byte CLEAR REQUEST packets. 


The Diagnostic Field in the Clear Request Packet for Type 1 Networks 


When the X25NPSI sends a CLEAR REQUEST packet, the "Clearing Cause" byte 
is set to X'00' and the diagnostic field byte is set to the following 
values: 


HEXADECIMAL VALUE EXPLANATION 


00 Disconnection upon request from the host, 

or if an ANS situation occurs 
45 Incoming call received and link not owned by SSCP 
84 PLP or LLC error 
A2 Invalid or unexpected control packet received 
EO Reset indication received while in VCM inoperative 
, status | 
E3 Incoming call received and VC not in answer mode 
E5 | Incoming call received and LLC type invalid | 
E6 Incoming call received and LLC type not. supported 
E8 Timeout on call request 
E9 Incoming call received for a callout only VC 
EA Incoming call received during NCP slowdown 
EB Reset indication while in VCM data transfer status 
EC Incoming call received and Switched Connection 


Terminator (CXDDSCT) not present 


The Diagnostic Field in the Reset Request Packet 


When the X25NPSI sends a RESET REQUEST packet, the "Resetting Cause" 
byte is set to X'00' and the diagnostic byte is set to the following 
values: 


HEXADECIMAL VALUE EXPLANATION 
00 Value required for type 2 networks 
82 Invalid or unexpected control packet received 
83 Disconnection upon request from the SSCP, or 
because an ANS situation has occurred 
84 PLP or LLC error 


LOGICAL LINK UNIT FORMAT 


An LLU is inserted in a frame in the following manner: 


(RRenae Semeias (Gace! amreata) Giuaiaa Giants” Saaeaal’ Ga (Amaanenamiaramaaiona ee | cae ae! cea 
| | | | Packet | LLC | ae | | | | 
|F[A]C] [level 2]  .PIU / | | Fcs | F | 
| | | | Header |Header | / f | | | 
a ee ee ey FG ae ee ee 

t t 

LLU t 

te >! 


The LLC header in LLC level 2 is made up of 2 bytes. 
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The following table shows the different types of LLU: 


fe eg, ee ge eee ee a ee ee ee ne 
| LLU TYPE | | Byte 0 | Byte l | 
eee eee bits | bits | 
|From 3705 to NIA From NIA to 3705/0 1234567012345 6/7| 


DATA—LLU | 
11110X10|/SSSSSSSS$§| 


| 
| Data LLU Data LLU | 
CONTROL LLU | 

PSCONT PSCONT | 

| 

| 

| 

| 


| | 
| 11110001/00001000 
| PSDISC PSDISC 11110001J/00000010 
| PSXID PSXID 11110001]/00000100| 
|. PSTEST PSTEST 11110001]/00000110 
| | | 


Where SSSSSSSS = N(S) = LLC Send Sequence Number 
Where X is the Segment Indicator: 
X=1 the LLU is not the last of a chain 


X=0 the LLU is the last of a chain or a unique segment. 
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COMMUNICATING WITH NON-SNA X.25 DTES 


The PCNE allows communications between a Host application using an SNA 
access method and a non-SNA X.25 DTE (terminal, cluster, or host). An 
SNA host connected to a 3705 running X25NPSI may itself be considered as 
a non-SNA X.25 DTE by another host; that is, PCNE-to-PCNE connection is 
allowed. The conversion is performed with some restrictions, both on 
the X.25 and on the SNA protocols. The limitations are described later 
in this section. 


Protocol conversion is performed only between the K.25 packet header (or 
some X.25 control/interrupt packets) and the transmission/request header 
of the SNA PIUs. Data contained in SNA FM request units or in data 
packets is not processed by the PCNE and is transferred end-to-end 
without any conversion. 


The PCNE simulates an SNA LU type 1, working in half-duplex mode 
(contention or flip-flop) with one local host application program. Only 
one LU can be associated with a PU; that is, on the X%.25 side, only one 
PU/LU pair can be associated with one virtual circuit (either permanent 
or switched). 


LIMITATIONS 


. There can be only one PU/LU pair per virtual circuit. As a result, 
there is only one APPL/SLU SNA session per virtual circuit. 


: Either half-duplex contention or half-duplex flip-flop mode is 
supported. 


: PCNE-to-PCNE communications are allowed in half-duplex contention 
mode. Because the X25NPSI provides for both inbound and outbound 
data queueing, a contention problem cannot cause any loss of data 
and the end-to-end data flow may be independent from the simulated 
SNA data flow. 


: To perform a full-duplex end-to-end data flow, either on PCNE-to 
PCNE or PCNE-to-X.25 DTE Communications, you must use an SNA session 
defined with the "Exception Response Mode" and "Single RU chain" for 
both flows: PLU/SLU and SLU/PLU. 


. Outgoing RUs (from the host) are converted into independent ees 
packets, whatever the setting of the chaining bits. 


e An incoming set of packets, linked by the "more data bit", is sent 
to the host as one RU OIC within a single segment. 


: The data part of the FMD RU in the PLU-SLU session is not processed 
by the PCNE; that is, the application must understand the data 
format of the X.25 equipment with which it communicates. The PCNE 
does not perform character stream mapping. 
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e Only the EBCDIC character code is supported. 


¢ The PCNE allows the connection of non-SNA X.25 DTEs only; that is, 
the "PAD" is not supported. 


e When calling a host over a switched virtual circuit, a non-SNA X.25 
DTE must insert the following in the Call User Data field of the 
CALL REQUEST packet: X'CO', followed by the five digits (two and 
one half bytes) of either | | 


- The "IDNUM=" parameter contained in the PU of the macro 
describing this equipment to VTAM, or | | 


- The identification number contained in the INVLIST macro 
instruction describing this equipment to TCAM. 


Remember that an SNA station identification is made up of four bytes: 
X'BBBNNNNN', where X'BBB' represents the identification block, and 
X'NNNNN' represents the identification number. 


ACTION ON PHYSICAL SERVICES REQUESTS 
IDENTIFICATION EXCHANGE 


Call-Out 


When the VCM receives a CONNECT-OUT with LLC=PCNEO, the last five digits 
representing the "SSCP identification number" as specified in the DIALNO 
keyword are stored in the SLUB. 


Then, the VCM builds a CALL REQUEST packet, with the following 
information in the lst byte of the Call User Data field: 


X'CO' if LLC=PCNEO was specified 


followed by a "remote identification number". This remote 
identification number is necessary, when the X.25 equipment is also a 
PCNE, to identify the remote PU of the remote SNA access method. The 
"remote identification number" is equal to the "SSCP identification 
number" value plus one, or to the "default identification number". 
Refer to the PU macro instruction in the "ACF/VTAM Considerations" 
section of this manual. 


After receiving the CALL CONNECTED packet, the PCNE gets the local ID 
from the SLUB and passes it to the physical services for insertion in 
the REQUEST CONTACT command sent to the host. 


Refer to the PATH macro instruction in the "“ACF/VTAM Considerations” 
section of this manual for the format of these CALL packets. 


Call-In 


When an. INCOMING CALL packet is received with LLC=PCNEO, the next two 
and one half bytes (representing the identification number parameter) 
are stored in the SLUB extension. The VCM sends the CALL CONNECTED 
packet, triggering the PCNE, which gets the ID from.the SLUB and passes 
it to the physical services for insertion in the REQUEST CONTACT command 
sent to the host. 


CONTACT /DISCONTACT 


1. When CONTACT is requested by the physical services, the PCNE 
triggers the physical services for a positive response if the 
multichannel link is in the ACTIVE status. 


2. When DISCONTACT is requested, the PCNE triggers the physical 
services for a positive response. All the packets received over 
the associated virtual circuits are discarded after the DISCONTACT 
processing. 


ACTION ON SESSION CONTROL RUS 


The PCNE supports the following session control RUs when they are issued 
by the host: 


ACTLU (Activate Logical Unit) 
BIND 

SDT 

CLEAR 

UNBIND 

DACTLU (Deactivate Logical Unit) 


A response is returned locally. 


ACTLU 


All pending conditions are cleared and the ACTLU IN PROGRESS status is 
entered. 


The positive response is immediately sent to the host, and the ONLINE 
status is entered. 


Note: The type of activation. (ERP, WARM, COLD) is not checked by the LU 
simulator. 

BIND 

The BIND parameters are checked against the values listed in Figure 4-1.. 


If valid, the BIND parameters are stored in the SLUB and a positive 
response is sent to the host. 
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Note: As for the ACTLU command, the type of activation (ERP, WARM, 
COLD) is not checked by the LU siamlator:. 


SDT 


The DATA TRAFFIC status is entered and a positive response is sent to 
the host. 


CLEAR 


All pending conditions are cleared locally, and a positive response is 
sent to the host. 


UNBIND 


The session condition is reset and a positive response is sent to the 
host. The ONLINE status waiting for DACTLU is entered. | 


DACTLU 


All pending conditions are cleared, a positive response is sent to the 
host, and the OFFLINE status is entered. 
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Gree ee IR ces “gees ge 8 we ee et a ee rig ee we eel 


| BYTES | BITS | VALUE | MEANING | 
Seca nce SAAN (eee ener ene 
| Oo | o-7 | X'31' | BIND code | 
| 1 | 0-3 | B'0000' | BIND format = 0 | 
| | 4-7 | B'0001' | BIND type =1 | 
| 2 | -O0s% |-xX*03° | FM profile = 3 | 
| 3 | 0-7 | x'03' | TS profile = 3 | 
| | | | DEFINITION OF PRIMARY PROTOCOL: | 
| | | | | 
| 4, | O i Be | Multiple request chains | 
| | 1 | B‘'O' | Mandatory value, immediate request | 
| | 2-3 | B'O1' | Exception response | 
| | | B‘'10' | Definite response | 
| | | B'll' | Exception and definite response | 
| | 4-5 | --- | Not used | 
| | 6 | B'O' | Compression not used | 
| es | Bi1' | Primary may send EB | 
| | | B'O' | Primary will not send EB | 
| | | | DEFINITION OF SECONDARY PROTOCOL: | 
| | | | | 
| 5 | O | Bil’ | Multiple request chains (the PCNE | 
| | | | always sends OIC RU to the host) | 
| | | B'O' | Mandatory value, immediate request | 
| | 2-3 | Biol’ | Exception response | 
| | | B‘'10' | Definite response | 
| | | B'i1' | Exception and definite response | 
| | 4-5 | --- | Not used | 
| | 6 | B'O' | Compression not used | 
| 7 | Bi’ | Primary may send EB | 
| | | B‘O' | Primary will not send EB | 


COMMON PROTOCOL: 


| | | | | 
| | | | | 
| 6 | oO | =--- | Not used | 
| | 1 | B'O' | FM header not used | 
| | 2 | Bil' | Bracket used | 
| | | B‘O' | Bracket not used | 
| es | Bi1' | Bracket termination rule 1 | 
| | 4 | B'O' | EBCDIC | 
| | 5-6-7| --- | Not used | 
| | | | | 
| | | | COMMON PROTOCOL: | 
| | | | | 
| 7 | O-1 | B'O1' | HDX Contention | 
| | | B'10' | HDX Flip-Flop | 
| | 2 | B'O' | Primary LU recovery responsibility | 
| i 3 | B'O' | First speaker is secondary | 
| | 4-7 | --- | Not used | 


Figure 4-1. The BIND Parameter List 
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ACTION ON DATA FLOW CONTROL RUS 


The PCNE supports the following DFC RUs when they are issued by the 
host: 


CANCEL 

SIGNAL 

BID 

CHASE 

SHUTD (Shutdown) 


The PCNE sends the SHUTC DFC RU to the host. 


CANCEL 


CANCEL is never sent by the PCNE. When CANCEL is received from the 
host, a positive response is sent back to the host without any other 
action. As a matter of fact, since the "chaining" concept in the PCNE 
is only local, the host application program needs a higher level 
end-to-end protocol to cancel such a chain of RUs. 


SIGNAL 
The user's data signals are not processed. 


The SIGNAL command is never generated by the PCNE. When the SIGNAL 
command is received from the host, a positive response is sent back to 
the host without further action. | 


BID (IN "BETWEEN BRACKETS" STATUS) 


The BID command is accepted if the HDX bracket status permits processing 
an RU request from the host with "Begin Bracket". In this case, the 
“Begin Bracket Pending" status is entered, and all data packets received 
from the network are held in buffers until the "Begin Bracket" RU is 
received. For more details, refer to the "Bracket Management" section 
of this manual. 


CHASE 


A positive response is sent to the host without further action. 


SHUTD / SHUTC 


As soon as the bracket status changes to BETB, after a SHUTD request is 
received from the host, the LU simulator sends a SHUTC request to the 
host, and all incoming data packets are discarded. 


Note: If the SLU can close the brackets, SHUTC can be sent after 
reception of the first packet without the "more data" bit. 
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ACTION ON FUNCTION MANAGEMENT (FM) DATA RUS 


Figure 4-2 illustrates the inbound and outbound flow of FM data RUs. 


OUTBOUND FLOW 


The PCNE does not support outbound SNA segmenting. For this reason, the 
MAXDATA parameter of the VTAM "PU" macro instruction, and of the TCAM 
"TERMINAL TERM=PUNT" macro instruction, must be coded with a value 
higher than the maximum RU size sent by the application. 


Each outgoing RU is sent as an independent set of packets. In each set, 
all packets except the last have the "more data’ bit ON in their packet 
headers. The last packet has its "more data" bit OFF. Adapting the 
data length to the characteristics of the connection is done by the PCNE 
in such a manner that all the packets with the "more data" bit ON 
contain a number of data bytes equal to the maximum packet length 
("MAXPKTL="" keyword) acceptable by the DTE interface. 


The chaining concept is not translated end-to-end. It is supported for 
compatibility purposes only. 


The outbound response protocol is defined in the BIND parameters by byte 
4, bits 2-3 (see Figure 4-1). Because the LU simulator works with a 
pacing equal to 1, the PCNE sends a response (IPR, +RSP, or -RSP) to 
each RU received from the host. If requested in the RH, the response is 
sent as soon as the first packet built from the RU is scheduled on the 
outbound queue. 


When received from the host, IPR and Definite Response mean only that 
the beginning of the RU is scheduled on the outbound queue. They do not 
mean that it has been correctly sent. An Exception Response means that 
the RU cannot be sent and has been discarded. 
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BNN | PCNE X.25 


1. RU (OIC) 
> 
+RSP (pace) MDB 
< > 
MDB 
> 
MDB 
> 
2. RU (FIC) 
> 
IPR MDB 
< > 
MDB 
RU: (LIC) o> 
> 
+RSP (pace) MDB 
< > 
MDB 
> 
33 MDB (held in buffers) 
Fea EE LEE aE ae TER 
MDB (held in buffers) 
< | | 
RU (OIC, OIS, EXR) MDB 
< $$ i 
4. RU (OIC) 
3 , > 
+RSP (pace) MDB | 
eee 
MDB 
> 
MDB (held in buffers) 
< 
MDB 
> 
RU (OIC, OIS, EXR) MDB 
$< 
MDB 


Figure 4-2 (1 of 2). Function Management Data Flow 


5. RU (FIC) 


> 
IPR | | MDB } 
< > } 
RU (MIC) — } (FIC) 
> MDB } 
> } 
IPR MDB 
<< 
RU (LIC) 
> MDB (held in buffers) 
<< 
MDB 
> 
MDB (held in buffers) 
< 
MDB 
> 
+RSP (pace) MDB 
5 ee a ate ee > } 
RU (OIC, OIS, EXR) MDB } 
peste ameter Steak eee ee ore > } 
MDB } (LIC) 
> } 
_ } 
MDB } 
> } 


Figure 4-2 (2 of 2). Function Management Data Flow 


INBOUND FLOW 


A set of packets with the "more data" bit ON in their packet headers (up 
to the first packet with the "more data" bit OFF) is sent to the host as 
an only-in-chain and single-segment RU. All data packets received 
‘during the transmission of a CHAIN by the host are held in buffers until 
the PCNE can deliver this data to the host (that is, until the PCNE 
processes the last-in-chain RU). 


Since each RU request sent to the host is sent as only-in-chain, the 
PCNE sets the response bits in the RH of each request based upon the 
value of the BIND parameters (byte 5, bits 2-3) for the 
secondary-to-primary protocol. The PCNE concerns itself with the 
response coming from the host (whether it is positive or negative) only 
when the request RU specifies a Definite Response. Otherwise, in 
Exception Response mode, the LU Simulator (LUSIM) internal status 
changes directly to standby as soon as the RU request is sent to the 
host. Use of the Exception Response mode for the secondary protocol 
facilitates inbound traffic flow, since in this case the PCNE does not 
have to wait for a response for each PIU from the host. 
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PACING 


The PCNE supports only outbound pacing, and sends a pacing PeePouse each 
time a request is received with the PACE bit ON. | 


Specifying PACING=(1,1) is mandatory for a PU working under LLC level 0. 
VPACING is independent of the X25NPSI. VPACING should be chosen with » 
regards to the host application and to the buffers available in the 
3705. 


Note: The PACING fields of the "BIND=" parameter should be coded 
according to this value. | 


Though the pacing information placed by the PCNE in a response does not 
result in the release of the buffers containing the corresponding RU | 
request, the PACING and VPACING concepts allow regulating the data flow 
between the host and the NCP. When determining pacing parameters, you 
sould take into account the packet window processing. In fact, an RU 
request from the host entering the NCP is processed by the PCNE only 
when the packet window is open -- that is, when the previous RUs have 
been sent to the network. 


FLOW DIRECTION CONTROL 


: In half-duplex contention mode, contention is resolved at the 
_ X25NPSI level by the PCNE, which uses outbound and inbound data 
queueing. 


° In half-duplex flip-flop mode, the PCNE changes its internal status 
when it receives a data packet from the network with the MDB turned 
OFF. Receipt of a data packet from the network with the MDB turned 
OFF causes the PCNE to send a request RU to the host with the 
"Change Direction" bit turned ON. 


CODE SELECTION 


The PCNE does not check the data contained in the data packets; however, 
the data contained in the LOGON message must be coded exactly as it is 
defined in the access method (VTAM/TCAM) USS conversion table, in order 
for the SSCP to establish a successful LU-LU session between a primary © 
LU located in the host and the secondary LU associated with the virtual 
circuit. For more information, see the "Logon Procedure" in the | 
following "Method of Operation" section. 


SEQUENCING 


Since the PCNE supports the FID3 TH only, the sequence numbers are 
managed by the BNN function of the NCP. | 


4-10 


METHOD OF OPERATION 


~ LOGON PROCEDURE 


A LOGON message is a PIU sent by an SLU during the SSCP-SLU session to 
request an APPL-SLU session. It takes place between the ACTLU and the 
BIND SNA commands. Therefore, any data packet received from an X.25 
equipment after transmission to the host of the +RSP to ACTLU, and 
before reception of a BIND command, is considered to be a LOGON message, 
and the PCNE delivers this packet to the host over the SSCP-SLU session. 


The LOGON information which may be contained is several data packets, is 
transferred to the host without being modified by the PCNE. The data 
format must be compatible with the USS definition table. 


° If you select the ACF/VTAM-supplied default USS conversion table, 
the LOGON message must be entered in the following format: 


LOGON [APPLID (name)] [LOGMODE (name)] [DATA (user data) ] 


° If you select the ACF/TCAM-supplied default USS conversion table, 
- the LOGON message must be entered in one of the following two 
formats: | 


INITS luname ,modename 
LOGON luname ,modename 


LOGOFF PROCEDURE 


The X.25 DTE has no means to request the SSCP to end the APPL-SLU 
session. You need a higher protocol at application level: the X.25 DTE 
can send special data information recognized by the application that 
will cause the application to request the SSCP to end the APPL-SLU 
session. 


- BRACKET MANAGEMENT _ 


The PCNE is always the first speaker. 


WHEN THE SLU (PCNE) CANNOT SEND EB 


1. The first data packet without MDB received from the X.25 DTE (see 
Figure 4-3) when the PCNE is in the BETB state causes the bracket 
state manager to enter the INB state, and an FMD RU with BB ON to 
be sent to the host. The PCNE remains in the INB state until it 
receives EB from the host. 


(2. Bracket initialized by a BID sequence: If the PCNE is in the BETB 
state and receives a BID from the host, a positive response is sent 


to the host and the BBP state is entered. All data packets 
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received white in this state are held in buffers until the BRACKET — 


and HDX states permit their processing. The INB state is entered 
when the first RU with BB set ON is received from the host. The 
INB state is left when an RU with EB set ON is received. 


Bracket initialized by a data RU (implicit BID): If while in the 
BETB state the PCNE receives from the host an FMD RU with BB set 
ON, the PCNE sends the data packet(s) to the X.25 DTE and enters 
the INB state. 


If the PCNE receives a BID while in the INB state, an error 
response is returned. 


If the PCNE receives an FMD RU with BB set ON while in the INB 
state, an error response is returned to the nee and the PCNE 
remains in the same state. 


BRACKET STATUS 


HOST 3705 X.25 EQUIPMENT 


~RSP with sense X'0813' 
< 


Ds FMD RU (BB) 


—RSP with sense X'0813' 
< 


| | 
1. BETB MDB 
t | te 
t | t 
FMD RU (BB) | INB ' MDB 
< | Lt 
FMD RU : | ' MDB 
> | ' > 
t | t 
' ' MDB 
t | q > 
| | t MDB 
] | te 
q | q 
FMD RU ; MDB 
< ! | Nig 
FMD RU (EB) | BETB — MDB 
: >! } q > 
q q 
| _— 
| MDB 
t | t > 
2 BID ' BBP | : 
, >! } t 
+RSP | ' 
< r | MDB 
t | te 
| | t 
t | ’ MDB 
t | '< 
FMD RU (BB, OIC) | INB ' MDB 
. . >) oS > 
q | q 
? | t MDB 
t | a > 
RU : ———! Data Packet 
< ; ae < 
P t t 
FMD RU (EB) BETB ; MDB 
> : > 
3. FMD RU (BB) : MDB 
> : > 
q q 
t t MDB 
q t > 
¢ t 
y | 
4, - BID : ; 
, t t 
t t 
t t 
q t 
q t 
t t 
t t 


ttl 


Figure 4-3. Bracket Protocol When the SLU Cannot Send EB 
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WHEN THE SLU (PCNE) CAN SEND EB 


1. If the PCNE is in the BETB state and receives a set of data packets 
with MDB set ON (up to the first packet with MDB set OFF), it sends 
one FMD RU with BB and EB set ON (see Figure 4-4). The PCNE 
remains in the BETB state. 


2. If the PCNE is in the INB state and receives a set of data packets 
with MDB set ON (up to the first packet with MDB set OFF), it sends 
the host one FMD RU with EB set ON. The PCNE then enters the BETB 


state. 
HOST 3705 | BRACKET STATUS | X.25 EQUIPMENT 
t t 
BETB : 
| ; MDB 
1. | "< 
| ; MDB 
t | ie 
q | t 
FMD RU (BB, EB) | MDB 
< : | " 
1 | q 
2 t | t 
FMD RU (BB) | INB MDB 
>.' |___._., : > 
t q 
t : t 
| MDB 
t | LZ 
t | t . 
| MDB 
FMD RU (EB) pee "< 
< t t 
—— 7 


Figure 4-4. Bracket Protocol When the SLU Can Send EB 


REMARKS CONCERNING A HOST-TO-HOST CONNECTION THROUGH THE PCNE 


The following considerations apply to a VTAM environment. Similar 
considerations would apply to a TCAM environment. 


Let the following configuration be considered: To each 3705 is 
connected a multichannel link on which are defined: 


. One permanent virtual circuit 


e Two switched virtual circuits 


: | | 
HOST#1 3705#1 | | 3705%#2 HOST}#2 
| | | 


r | ise ee eet. a] ar ieee Readies) | fo ‘ 
| | | | | | | | | | | | 
| | | eos. PVG. ss4 pee PVG: See | | | | 
| | | | | | X.25 | | | | | | 
|APPL 11----4 |PCNE'--SsVC 1--/ L--SVC 1--/ PCNE| L.----/ APPT, 2| 
| | | [| | NETWORK | | | | | | 
| | | | L--syc 2--4 L--syvc 2--4 | | | | 
| | | | | | | | | | | | 
| | | | | === | | == | | | | | 
eee J Lieve cade eee eal Le sitaeias \coee ace! bial to ® Gos xl 


Data has to be transferred from the APPL 1 application to the APPL 2 
application and vice versa, with either application being able to 
initialize the connection. 


CONNECTION THROUGH SWITCHED VIRTUAL CIRCUITS 
1. Definition.of the "Switched Major Nodes": 
The configuration shows two distinct SNA domains: 
SNA domain 1 consisting of Host#1 and 3705#1. 
SNA domain 2 consisting of Host#2 and 3705#2. 
The only relationship between the two SNA domains is made by the 
Remote Identification number specified in the CALL REQUEST and 
INCOMING CALL packets. This identification number is used by the 
called SNA domain to identify the corresponding PU and LU in its 
own domain. — | 
In the VTAM environment, the "Remote Identification number" is 
equal to the "SSCP Identification number" of the calling SNA domain 


+1; therefore, you have to choose the values of the 'IDNUM=" 
parameter in both domains carefully. 
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You are advised to use the following table: 


Pee , 
| SNA Domain 1 | SNA Domain 2 | 


Pugs PU bats | 
IDBLK= 003 
IDNUM= 00001 


IDBLK= 003 
IDNUM= 00001 


PATH11 PATH PATH21 PATH 


DIALNO= ...00001 DIALNO= ...00001 


LU21 LU 


| | 
| ee ic} | 
| IDBLK= 003 IDBLK= 003 | 
| IDNUM= 00002 IDNUM= 00002 | 
| a ae | 
| | 
| | 
| | 


IDBLK= 003 
IDNUM= 00003 


IDBLK= 003 
IDNUM= 00003 


PATH13 PATH PATH23 PATH 


DIALNO= ...00003 DIALNO= ...00003 


LU23 LU 
IDBLK= 003 IDBLK= 003 


| | 
| | 
| | 
IDNUM= 00004 | IDNUM= 00004 | 
oe | gma | 
| | 
| | 


The first digit in PUxx, PATHxx, and LUxx indicates the SNA domain. 
The second digit in PUxx, PATHxx, and LUxx indicates the LU number. 


You have to define a number of LUs equal to twice the number of 
switched virtual circuits. The odd-numbered LUs are used for the 
outgoing calls. The even-numbered LUs are used for the incoming 
calls. No PATH macro instruction is defined in such an entry. 
For example, a connection from APPL1 to APPL2 will use: 
Either LU11 connected to LU22, or 
LU13 connected to LU24. 
Note: The first digit, which indicates the SNA domain, can be 
Suppressed, because the two SNA domains are completely 
distinct. It was specified for explanation purposes only. 
Session Setup and Session Shutdown (refer to Figure 4-5): 
Assume that the APPL1 application initializes session setup. It 
executes an OPENDST (ACQUIRE) macro instruction which results in 
the establishment of the required sessions: 
a. In SNA domain 1: 
SSCP1-PU (ACTPU) 
SSCP1-LU (ACTLU) 
APPL1-LU (BIND) 
b. In SNA domain 2: 
SSCP2-PU (ACTPU) 
SSCP2-LU (ACTLU) 
To request the establishment of the APPL2-LU session in SNA domain 
2, the APPL1 application must send a LOGON message as standard 
data. In SNA domain 2, this LOGON message can be forwarded to 
SSCP2 only if the SSCP2-LU session is already established. This is 


the reason why the PCNE retains any data packet up to the ACTLU 
command. 
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CC ee ee 


3 Data containing logcff 
SEND 


j SECOWDA RY { 
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{ 
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Figure 4-5. 
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Session Setup/Shutdown Through an SVC (APPL-toAPPL Connection) 


~~. SEND and RECEIVE macros 


‘Upon receipt of the LOGON message, SSCP2 schedules the LOGON exit 
routine of APPL2 which performs an OPENDST (ACCEPT). Thus, the 
APPL2-LU session is established. Receipt of the SDT message allows 
the PCNE to forward the data packets coming from the network to 
APPL2 and no longer to SSCP2. Thus, APPL1 must wait for a "Logon 
Acknowledgment" sent by the APPL2 logon exit routine before sending 
data to APPL2. You may have to utilize a timer in APPL1 to cover 
the cases of non-response to a LOGON message. 


Before performing a CLOSEDST macro instruction to end an APPLl to 
APPL2 connection, an application must send as normal data LOGOFF 
information requesting the application in the other domain to end 
its APPL-LU session. 


CONNECTION THROUGH PERMANENT VIRTUAL CIRCUITS 


The above discussion of connection to SVCs applies in general to PVCs as 
well. However, unlike an application working with an SVC, a called 
application working with a PVC does not necessarily need a LOGON 
message. It can be in a state allowing itself to receive data from the 
other side's application directly. In fact, an application may issue an 
OPENDST (ACQUIRE) macro instruction resulting in the establishment of 
the APPL-LU session without any impact on the X.25 network. 


COMMUNICATING WITH THE X.25 NETWORK SERVICES 


The X25NPSI allows communications with the ECHO service of the network, 
if any. The X25NPSI sees the ECHO service as an X.25 non-SNA DTE 
working in LLC level 0. The PCNE allows these communications by 
simulating an SNA secondary LU associated with a type 1 PU. 
Communications with the ECHO service are allowed through switched 
virtual circuits only. Thus, the pseudo-type 1 PU used for the 
communications must be switched and, for VTAM, defined as such in the 
switched sub-area's major node. | 


In an X.25 generation deck, the PCNE support is included when you 
specify LLC=PCNEO anywhere in the deck. 


Once the communication has been established with the ECHO service of the 
network, using network specifications, link test level 2 or an 


application program can be used to perform the echo. 


Refer to the host access method's Operator's Guide to learn how to 
perform link test level 2 for leased circuits. 
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X25NPSI_ INSTALLATION 


DISTRIBUTION PACKAGE 


After you have installed your basic NCP library with the Standard 
ACF/NCP/VS package, you must install X25NPSI using SMP for OS/VS and 
MSHP for DOS/VS. 


You should carefully refer to the instructions given in the "PROGRAM 
DIRECTORY FOR USE" of the X25NPSI in order to select the correct files 
on the tape. 


OS/VS X25NPSI LIBRARIES 


The following library is restored from the X25NPSI tape: SYS1.GEN3705xX, 
which is used for X.25 stage 1, concatenated to the NCP SYS1.GEN3705. 


JOB CARD MODIFICATION 


You can supply your own JOB card by replacing the JOBXCARD member of the 
SYS1.GEN3705X library. An example of JCL you could use to effect this 
replacement follows: | 


//S1 EXEC PGM=IEBUPDTE , PARM=NEW 
//SYSPRINT DD SYSOUT=A _ | 
//SYSUT1 DD DSN=SYS1.GEN3705X,DISP=SHR 
//SYSUT2 DD DSN=SYS1.GEN3705X ,DISP=SHR 
//SYSIN DD DATA,DLM=ZZ 

./ ADD NAME=JOBXCARD , LIST=ALL 
//&JOBNAMC JOB (xxx,yyy), 

// progname ,MSGLEVEL=(1,1),CLASS=A 

ZZ | 


The JOB name (variable &JOBNAMC) is prepared by the generation 
processor. You can code a user name instead but, in this case, if you 
code JOBCARD=MULTI in the X25BUILD macro, all the X25NPSI's stage 2 jobs 
will have the same name, unless you affix &SNDA to the name (fo1 example 
when coding the jobcard as follows): 


//USER&SNDA JOB (xxx,yyy), 


The jobnames will be USER1, USER2, USER3. &SNDA is incremented by 1 for 
each job. 


¢ The SYS1.MAC3705X library contains X25NPSI macros to assemble the 
code produced by X.25 Stage 1 during the first assembly of the NCP's 
stage 2. It must be defined as one of the MACLIB suboperaids of the 
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_ NCP BUILD macro. 


° The SYS1.0BJ3705X library contains the X25NPSI load modules and 
corresponds to the library specified by the "QUALIFY=" and 
"USERLIB="" operands of the NCP BUILD macro. 


When several programs use the Customization Facility (for instance 
X25NPSI and Network Terminal Option), the object modules of the 
different programs have to be in the file corresponding to the 
USERLIB operand of the NCP BUILD macro instruction. 


If you want to use different files for the object modules, you have 


to modify the link-edit job by enone tre these files in the ULIB 


' DD statement. 


The following working libraries are required for stage 2 of the NCP 
generation: 


° A library defined in the first MACLIB suboperand of the NCP BUILD 
macro. Optionally, it can be the’ same as the SYS1.MAC3705X 
described above, but this is not recommended. This library will 
contain the result. of the X.25 generation and will be used as input 
for stage 2 of the NCP generation. 

° The library defined in the OBJLIB operand of the NCP BUILD macro. 


¢ The library defined in the LOADLIB operand of the NCP BUILD macro. 


DOS/VS X25NPSI_ LIBRARIES 
The following libraries are restored from the X25NPSI tape: 


° The source library (F sublibrary.) for the xX. 25 stage 1 run and for 
the ACF/NCP stage 2 assembly run. 


° The relocatable library containing the K25NPSI object modules. 
These libraries are the same as (or must be concatenated to) the 
libraries used by ACF/NCP. 

USER GENERATION PROCESSING 

After ym install the libraries described above from the X25NPSI tape, 


as explézined in the Program Directory that is shipped on the tape, 
proceed as follows. 


X25NPSI GENERATION 


X25NPSI Network Description 


Using the X.25 macros described later in this chapter, you must define 
your attéchment to the Packet Switching Network. | 


5=2 


X25BUILD 
X25VC for an automatic naming of resources 
or 
linename X25LINE | 
puname X25PU to choose your own resources names 
[luname X25LU] 
X25END 
These macros will produce all the input required for the X.25 part of 
the NCP generation. In particular, they will prepare descriptions of 


X25NPSI control blocks that will be assembled in the first assembly of 
stage 2 of the NCP generation, together with the NCP control blocks. 


X25NPSI Stage 1 


X25NPSI stage 1 is an assembly step and produces job control language 
for the X.25 stage 2: See box 1 in Figure 5-1. The OS/VS or DOS/VSE 
Assembler must be used. 
Use the following JCL: 
OS/VS 

//STEP1 EXEC PGM=IFOX0O,.... 


/ /SYSLIB DD DSN=SY81.GEN3705X,DISP=SHR 
// DD DSN=SYS1.GEN3705 , DISP=SHR 


At least a 1536K partition is required. 


Note: 
You can also use the Assembler H. 


//STEP1 EXEC PGM=IEV9O,.... 
DOS/VSE 


// OPTION DECK ,NOEDECK , SUBLIB=DF 
// EXEC ASSEMBLY 


At least a 1224K partition is required. 


X25NPSI Stage 2 


X25NPSI stage 2 consists of eight update steps (box 2 in Figure 5-1) © 
that prepare the input for the X25NPSI part of the NCP generation: 
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1. Your source members that are copied by the first assembly of the 
NCP generation's stage 2 to create the X25NPSI control blocks in 2 
CSECTs: 


a. SSRCLO, which contains the UACBs. | 
b. SSRCHI, which contains all other X25NPSI blocks. 


2. The linkedit control statements to include the adequate 
pre-assembled X25NPSI modules. 


3. A member containing the NCP stage 1 macros for the K25NPSI 
attachment: GROUP, LINE, PU, LU, and GENEND macros. The name of 
this member is specified by the "NCPSTG1="" operand of the X25END 
macro instruction. The names of the resources are assigned by 
X25NPSI and you can change them if they do not fit your 
requirements. 


In OS/VS only, X25NPSI stage 1 output is placed by the X25NPSI stage 2 
in the user library defined in the first or only suboperand of the 
"MACLIB="" operand of the NCP BUILD macro. In DOS/VS, X25NPSI stage 1 
output is placed by X25NPSI stage 2 in the source library. 


NCP GENERATION 


NCP Description 


Get the source code contained in the last member prepared by X25NPSI 
stage 1 and insert it in your NCP deck as if you were defining SDLC 
lines. 


This member contains the GROUP, LINE, PU, LU, and GENEND macros for 
X25NPSI. The name of this member is specified by the "NCPSTG1=" operand 
of the X25END macro. You may modify this code to fit your special 
requirements. 


NCP Stage 1 


Stage 1 of the NCP is an assembly (box 3 in Figure 5-1). It is done 
with the standard library and with the IBM 3705 assembler. 


Use the JCL described in Chapter 4 of ACF/NCP/VS Installation Release 
2.1, SC30-3142, that is: 
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OS/VS 
//STEP1 EXEC PGM=CWAXOO,.. 
/-/SYSLIB DD DSN=SYS1.GEN3705 , DISP=SHR 


//SYSIN DD * 
BUILD 


(definition of resources other than X.25 ones) 
(source code punched in the member of the MACLIB defined 
in the NCPSTG1 operand of the X25END macro) 
END 
DOS /VSE 


// EXEC IFZASM 


NCP Stage 2 


Then perform stage 2 of the NCP's assembly (see box 4 in Figure 5-1), 
and the final linkedit (see box 5 in Figure 5-1). 
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Figure 5-1. 
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X25NPSI STAGE 1 GENERATION MACRO DESCRIPTION 


The stage 1 user macros describe the K25NPSI network. They are: 


X25BUILD 
X25NET One for each network. 
X2Z25VCCPT One for each filled VCCPTIT entry. 
X250UFT One for each filled OUFTIT entry 
(one VCCPTIT and one OUFTIT per network). 
X25MCH One per MCH and at least one per network 
X25 LCG One per logical channel group, and 
at least one per MCH. 
X25VC At least one per logical channel group. 
or 
{X25LINE} One per virtual circuit. 
{X25PU } One per virtual circuit. 
{X25LU } At least one per permanent VC. 
X25END 


These macros generate input for the NCP generation. 


X25BUILD MACRO INSTRUCTION 


This macro starts the generation process for the X25NPSI control blocks. 
Among its operands, five are the same as those of the NCP BUILD macro: 
JOBCARD, MACLIB, OUTPUT, QUALIFY, TYPSYS. 


Dy ei pe te ee ee ee ee ee es ee 


| Name | Operation | Operands | 
| Symbol | X25BUILD | [MCHCNT={count}] | 
| | | {1 | 
| | | | 
| | | [JOBCARD={NO_ }] | 
| | | {MULTT} | 
| | {YES } | 

| 
| | | [,MACLIB=dsname ] (OS only) | 
| | | | 
| | | [,OUTPUT=iebupdte ] (OS only) | 
| | | | 
| | | [,QUALIFY={NONE }] (OS only) | 
| | | {symbol} | 
! | {Ssys1 } | 

| 
| | | [,SRCPRFX={prefix}] | 
: : (X25 } | 

| 
| | | [,SRCLO={name_ }] | 
| | | {X25TBL}] | 


Da ee 
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| Name | Operation | Operands | 


(i 


[,SRCHI={name_ }] 
{X25BLK} ] 


| | 
| 
| [,TYPSYS={DOS} ] | 
| {OS }] | 
| [,SNAP={YES} ] : 
| 


| 
| 
| 
| 
| 
| 
| {NO }}] 


ee ets cierere crest (acerca Pt Dee rene eee) Ee a te oe Pots OLGTd er Rese tt eRe at eR 


MCHCNT=count 


Specifies the number of MCHs defined in this X25NPSI generation. 
The default value is l. 


JOBCARD=YES /NO/MULTI 


Specifies whether the program generation procedure is to provide a 
job card for the stage 2 input stream, and whether the input stream 
will consist of more than one job. 


If you specify JOBCARD=YES or omit the operand, a single job card 
is provided and the stage 2 input stream will consist of a single 


job. 


If you specify JOBCARD=MULTI, a job card is provided for each step 
and the stage 2 input stream will consist of multiple jobs: 


e 2 for the SRCLO and SRCHI members 


e 3 for the INCL2L0O, INCL2HI, and INCINIT members in OS/VS and 
DOS/VS | 


° 3 for the ORDL2LO, ORDL2HI, and ORDINIT members in OS/VS only. 
: 1 for the NCP stage 1 layout. 
See the earlier section of this chapter titled "JOB Card 


Modification" to find out how to supply a JOB card different 
from the default JOB card used in OS/VS. 


MACLIB=dsname 


Is the name (0S/VS only) of the output library for the X25NPSI 
stage 2. This operand is required if the OUTPUT operand is not 
coded. It is ignored if the "OUTPUT="' operand is coded. The data 
set may or may not be qualified depending on the "QUALIFY="" operand 
of this macro. This data set must be cataloged and must be the 
first suboperand in the "MACLIB="" operand of the NCP BUILD macro. 
The dsname can be MAC3705X. 


OUTPUT=(iebupdte) 


Specifies the name (0OS/VS only) of a cataloged procedure used in 
lieu of the normally generated JCL when performing an X25NPSI 
generation. 


QUALIFY=s ymbol /NONE/SYS1 


For OS/VS only (same as for the NCP), this parameter indicates the 
first level qualifier for OS/VS data sets specified by the 
"MACLIB="" operand of this macro and of the corresponding NCP BUILD 
macro. SYS1 is the default value. This operand is ignored when 
the 'OUTPUT="" operand is coded. 


SRCPRFX=prefix/X.25 
Specifies the 1 to 5 characters used as prefixes to give names to 
the members containing SRCLO and SRCHI created by this assembly in 
the MACLIB. The default value is X25. The first character must be 
alphabetic, except for $. 

SRCLO=X25TBL/name 
Specifies the name of the member to be used in the MACLIB to store 
the X25NPSI tables. The default name is X25TBL. 

SRCHI=X25BLK/name 
Specifies the name of the member to be used in the MACLIB to store 
the X25NPSI control blocks. The default name is X25BLK. 

TYPSYS=0S/DOS 
Specifies whether stage 2 of the X25NPSI generation procedure is to 
be run under OS/VS or DOS/VS. The default value is OS. 

SNAP=YES /NO 
Specifies whether the SNAP facility is active in the actual 
generation. The default value is NO and means that the internal 
SNAP facility is not active. 

° Programming Note (OS/VS only) 

- In both the BUILD (ACF/NCP) and X25BUILD macros, the operand 
"QUALIFY="" must be coded the same or omitted (the default value 
is then SYS1). If the qualifier is not SYS1 (if it is X25 for 
example), the two libraries SYS1.MAC3705x and SYS1.0BJ3705X must 
be renamed X25.MAC3705X and X25.0BJ3705X respectively, and 


cataloged. | 
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- The "MACLIB="" operand of the X25BUILD macro accepts only one 
dsname (such as USERX25). 


- The "MACLIB=" operand of the BUILD macro (ACF/NCP) accepts up to 
five dsnames. The first of these dsnames defines the library in 
which the members prepared by stage 1 of the X25NPSI generation 
process are stored. The other dsnames can be used to define the 
libraries in which the user macros required for the first 
assembly step of stage 2 of the NCP are stored. 


These dsnames will be concatenated in the MACLIB DD card for the 
first assembly of stage 2 of the NCP. In the final linkedit, 
only the first dsname will also be used to search for the 
INCLUDE and ORDER control cards. | 

X25NET MACRO INSTRUCTION 


This macro is used to specify and start the description of an X.25 
network. 


| ae | __ 


| Name | Operation | Operands | 
symbo 1 X25NET NETTYPE=ID 
[ ,;CPHINDX={ index} ] 


[ ,OUHINDX={ index} ] 
{1 } 


| l | | | as ) 


| | | 
| | | 
| | | {1 } 
| | | 
| | | 
| | | 


symbol 


This is an optional label. 


NETTYPE=I1D 


Specifies the ID number given to this network. The following ID 
numbers are defined: 3 


ID= 1 TRANSPAC , EURONET 
ID= 2 DATAPAC , DATEX-P., NRW 
ID = 3 Reserved 

ID= 4 Reserved 

ID= 5 Reserved 

ID= 6 Reserved 


The other networks will have an associated ID number after the 
completion of their attachment tests. 
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| From the point of view of the X.25 NPSI Internal Processing, the 
| differences between a Network Type 1 and 2 are the following: 


| 1. Clear Request/Indication Packets for Network Type 2 are only 

| 4-bytes long. No diagnostic byte is accepted/provided by a 

| Network Type 2 in these packets so that no end-to-end information 
| is propagated between DTE's. 


2. Reset Request Packet: There is no end-to-end DTE information 
forwarded by a network Type 2 for this packet. As a matter of 
fact, the diagnostic byte in a Reset Request Packet, accepted by 
a Network Type 2, must be equal to X'00'. 


| 3. The meaning of the cause byte in a Reset Indication Packet is not 
| always the same: 
| ° For Type 1 networks: 


| ‘Remote DTE Operational’ condition is specified by a cause byte 
| eqal to X'09'. 


| ‘Network Operational’ condition is specified by a cause byte 
| equal to X'OF'. 


| ¢ For Type 2 networks: 
| The two previous conditions are identified by a single cause 


| byte equal to X'00', which is called ‘End of out-of-order' 
| condition. 
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5-10.2 
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CPHINDX=index/1 


Specifies the highest index used in a dependent X25VCCPT macro for 
this network. The default value is l. 


OUHINDX=index/1 


Specifies the highest index used in a dependent X250UFT macro for 
this network. The default value is l. 


X25VCCPT MACRO INSTRUCTION 


This macro instruction describes the VC's connection parameters. At 
least one X25VCCPT macro is required, and up to 19 X25VCCPT macros can 
be coded per network. One macro is required for each filled entry of 
the VCCPTIT. Consecutive entries need not be used. The length of the 
table is specified by the “CPHINDX="' operand of the X25NET macro. 


An entry in the VCCPTIT will be used for each VC defined in this 
network. Please refer to the "VCCINDX=" operand of the X25VC macro for 
more details on how to use this table. 


' ' U t 


| Name | Operation | Operands | 
X25VCCPT INDEX=index, 


MAXPKTL=size 


2 2 


[, INSLOW={ (percentl,percent2) }] 


| 
| 
| 
| 
| 
| 
| {(25,0) } 


| 
| 
| 
| 
| [,VWINDOW={value} ] 
| 
| 
| 
| 


INDEX=index 


Specifies the index into the VCCPTIT for the entry being 
initialized by this X25VCCPT macro. For example, if INDEX=3, this 
X25VCCPT macro initializes the third entry in the VCCPTIT. The 
valid values for this index range from 01 to 19. 


MAXPKTL=size 


Specifies (in bytes) the maximum length of the packets to be sent 
or received over the VCs using this entry in the VCCPTIT. The 
valid range is from 32 to 4096. There is no default size. This 
length is the maximum length of data in a packet, excluding the 
length of the packet header. 
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Note: 
the 


Make sure that the number of inbound packets accumulated via 


More Data Bit (MDB) for LLC level 0, and by the Segment 


Indication (SI) of the LLC level 2 header, is such that the length 
of the accumulated PIU does not exceed the maximum length that can 
be transferred to the host during a READ operation -- that is, it 
must be less than: MAXBFRU multiplied by UNITSZ. 


VW INDOW=value 


Specifies the value of the transmit/receive window used by the 
packet protocol for the VCs using this entry. This value must be 
less than the modulo value used by this protocol, which is 8 for 
most of the networks. 


INSLOW=(percentl,percent2) 


Specifies the percentage of free buffers that must be reached 
before entering: 


° The UNSAFE situation (percentl), or 


e The DANGER situation (percent2) 


for the VCs using this entry. The valid values are 0, 6, 12, 
25, 50, or 100. When this operand is coded, both values must 
be specified and "percent1" must be greater than or equal to 
"percent2". The default values are (25,0). 


Note: The "“percent1" and "percent2" values are defined in 


terms of the NCP's "SLOWDOWN="" parameter of the BUILD macro. 
The default values of "percent1" and "percent2" (25,0) mean 
that the UNSAFE limit is 25% higher than the NCP SLOWDOWN 
value, and that the DANGER limit (0%) is equal to the NCP's 
slowdown value. 


X250UFT MACRO INSTRUCTION 


This macro is used to specify which user facilities and Call User Data 
field will be copied in the OUTGOING CALL packet as is. Refer to the 
discussion of the ACF/VTAM PATH Macro Instruction later in this chapter 
for more details on how to use this macro. 


From 1 to 19 X250UFT macros may be coded for each network. One macro is 
required for each filled entry of the OUFTIT. Consecutive entries need 
not be used, but the length of the table is specified by the "OUHINDX=" 
operand of the X25NET macro. At least one X250UFT macro is required for 
each network that has switched virtual circuits. No X250UFT macro is 
required when only permanent virtual circuits are in the network. 


nena 
| Name | Operation | Operands | 


Jn 


X250UFT INDEX=index 


| | | | 
| | | | 
| | | [OPTFACL=ala2a3a4blb2b3b4....212223z4] | 
| | | | 
| | | [,USRFILD=hexavalue] | 
Bs a eS rt ae oe ce a a ease hoe ce ea ae a OS te ee 


INDEX=index 


Specifies which index value of the OUFTIT allows gaining access to 
this OUFT. The valid values for this index range from 01 to 19. 


OPTFACL=ala2a3a4b1b2b3b4....2122232z4 


Specifies the hexadecimal configuration to be copied in the 
optional facility field of a Call Request packet. The number of 
hexadecimal characters must be a multiple of 4 (less than or equal 
to 16). The description of an optional facility is made by four 
hexadecimal characters. The first two give the facility code, and 
the last two describe the’ facility parameter field. 


USRFILD=hexavalue 


Specifies the correct bit configuration to be copied, as is, in the 
User Data field of the call requested packet. "hexavalue" must 
contain an even number of digits (less than or equal to 16). This 
value does not include the LLC type because it is used for outgoing 
calls only. 


Note: The following is an example of X250UFT macro instruction: 


| Name | Operation | Operands | 
X250UFT INDEX=1 , xX 


| | 
| | 
| | 
| | 
| | 


| OPTFACL=0312, X | 
| | 
| | 


USRF ILD=123456789ABC 
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MKB 
| 


1 


2 


OUFTIT 

0 | |000000] eS eaveurae 

[japeesss| sOURT | 

|) JOURTIG| =) on ae | 

| ————_—__ | | [ooo6| =| |123456789ABC | 

| | | |0003 | |02]0312| | 
i cn a ee ee ee 

ae es a ae 

|--__—__ L__>. q1..4 

n | | | 

ate eee 


X25MCH MACRO INSTRUCTION 


This macro instruction is used to describe a multichannel link. 
invoked, it creates one BAK2MCH macro. 


| Name | Operation | Operands 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


[symbol ] 


X25MCH CSBTYPE={ 2}, 


13} 

ADDRESS=(xxx, rrr), 
LCGDEF=[(]lcg(lenhi)[,lcg(lcnhi),.. 
FRMLGTH=length, 
MW INDOW=w indow 
[ ,STATION={ DCE} ] 

{DTE } ] 

{LAP }] 


[ ,RETRYCT={ count } ] 
{7 } 


[ ,RETRYTO={ timeout } ] 
{1 } 


[,NRZI={NO }] 
{YES} 


[ ,NCPGRP={ label}] 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
: 
! {NEW } 
| 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| [,PROTCOL={LAPB} ] 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


[ ,MACB=(labelx, labelr) ] 


-)I; 


When 
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Pere a re ne eg te Og ee ie oh ee aN ie ay 
| Name | Operation | Operands | 


| | | [,SPEED={value} ] | 
| | | {4800 } | 
| | | | 
| | | [,PUNAME=label] | 
| | | | 
| | | [,LUNAME=label ] | 


Dk a eee 


symbol 


This is an optional Label. When coded, it overrides the automatic 
resource name generation for the corresponding NCP line. See the 
earlier "NCP Stage 1 System Generation’ section of this manual for 
more details. 


CSBTYPE=2/3 


Is coded 2 if this interface is on a CSB-2. Is coded 3 if this 
interface is on a CSB-3. 


ADDRESS=( xxx, rrr) 


specifies the TRANSMIT and RECEIVE line interface addresses in 3 
hexadecimal digits each. 


LCGDEF=1cg(lcnhi) 


For each Logical Channel Group (LCG), this operand specifies the 
highest logical channel number (lcnhi). At least one pair of 
values lcg(lcnhi) must be defined. A maximum of sixteen pairs of 
values can be coded in any order, between parentheses and separated 
by commas. Only defined LCGs should be mentioned. 


FRMLGTH=length 


Specifies (in bytes) the maximum length of the frames that may flow 
over the MCH (X.25 Nl parameter divided by 8). The valid range of 

values is from 35 to 4099. This length is equal to the data packet 
length plus that of the packet header -- that is, the length of the 
data frame. 


MW INDOW=w indow 


Specifies the size of the window to be used by the Link Access 
protocol. The valid range of values is from 1 to 7. 


Note: This value is used to compute the number of entries (NOE) in 
the Line Input Queue (LIQ). NOE = 2 X window. 
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STATION=DTE& /DCE 


Specifies whether this link station (NCP) will operate as a DTE or 
a DCE. DTE is the default value and must be used for a normal 
connection to a network node (usually a DCE). 


The only effect of this parameter is to change the primary link 
address of the interface (it has no impact on packet level 
protocol). 


PROTCOL=LAPB/ LAP 


Specifies the link access protocol to be used. The default value 
is LAPB. 


RETRYCT=count 


Specifies the number of retries on the MCH (X.25 N2 parameter). 
The valid range is from 3 to 31. The default value is 7. 


RETRYTO=t imeout 


Specifies the value of the timeout used between retransmissions 
(X.25 Tl retry parameter). The value is 1, 2, or 3 seconds. The 
default value is 1. 


NRZI=YES/NO 


Specifies whether or not the DTE must operate in NRZI mode. The 
default value is NO. This parameter is reserved for future use. 


NCPGRP=label/NEW 


Optionally, "label" specifies the label of the new NCP GROUP macro 
where the actual MCH is defined in the NCP’s stage 1 deck. You 
usually do not have to specify this value, in which case the name 
is chosen by the X25NPSI stage 1 generation. You may code this 
operand when you modify an existing generation and do not’want to 
modify the NCP labels. 


If this operand is omitted, the built-in label is XNETn1 where "n" 
is the position of the previous X25NET macro within the X25NPSI 
generation. | 


If you specify NEW, a new NCP GROUP is created. The name of this 
new NCP GROUP is built using the automatic naming convention. 


If you specify a label, a new NCP GROUP is created with this label 
as the name of the GROUP macro. 


MACB=(labelx, labelr) 


This parameter is optional and specifies the labels of the user's 
ACBs. These labels are normally chosen by the actual X25NPSI stage 
1 generation. You may code this operand to prevent label 
duplication with other resource names in the same generation. 


If you do not code this operand, the UACB labels will be XMCHxxxx 
and XMCHxxxR, where xxx is the first suboperand of the 'ADDRESS=" 
operand. 


SPEED=value 


Specifies the speed of the MCH. This value is used to code NCP 
macros only (GROUP and/or LINE). The valid range of values is from 
1200 to 56000 bps. 


PUNAME= label 


This parameter is optional and specifies the label of the PU 
associated with an MCH line, as chosen by the user to prevent label 
duplication either inside the same generation, or inside VTAM 
during node activation. See the section of this chapter titled 
"NCP Stage 1 System Generation" for more details on automatic name 
generation. 


LUNAME=label 


This parameter is optional and specifies the label of the LU 
associated with an MCH line, as chosen by the user to prevent label 
duplication either inside the same generation, or inside VTAM 
during node activation. See the section of this chapter titled 
"NCP Stage 1 System Generation" for more details on automatic name 
generation. 


X25LCG MACRO INSTRUCTION 


This macro instruction begins the description of one LCG. One such 
macro must be coded for each LCG defined on this multichannel. 


[ar ee 


| Name | Operation | Operand | 
Seieeties sesetstatl: Steen eee Eon eee ee eee 
| | X25LCG | LCGN=number | 


Mo a a a i a Fe ie a tt 
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LCGN=number 


Specifies the Logical Channel Group Number (LCGN) for all the 
virtual circuits specified by the subsequent’ X25VC macros. The 
valid range of values is from 0 to 15. 


Note: If more than one LCG is to be used, the X25LCG macros must 
be coded with the LCG numbers in ascending order. However, a 
starting LCGN # 0, or discontinuities in the ascending sequence, 
are allowed. 


X25VC MACRO INSTRUCTION 


This 


macro instruction describes the characteristics of the VCs 


pertaining to the MCH and to the LCG previously defined. 


One X25VC macro may describe one or several virtual circuits that have 
the same characteristics. On output, one BAK2VC macro is punched for 
each virtual circuit and is coded as follows: 


Gs Pa a 
| Name | Operation | Operands 


[symbol 


X25VC LCN=(numberl,number2), 


VCCINDX=index, 
LLC=llcn 


[ , TYPE={ SWITCHED , OUFINDX=index, LLCLIST=(11c0,11c2,...)} 
{ PERMANENT} 


[,CALL={OUT }] 
{IN } 
{ INOUT} 


[ ,NCPGRP={ label} ] 


] | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
: 
| {NEW } 
| 
| 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


[ ,VACB=LABEL] 


I I ea race ec ee he 


symbol 


This is an optional label. 


LCN=(numberl1 ,number2 ) 


Specifies that the virtual circuits which have as LCNs numberl to 
number2 are defined sequentially. numberl and number2 are in 
decimal notation. The valid range of values is from 0 to 255. 
Some networks do not use the value 0. 


VCCINDX=index 


When TYPE=PERMANENT is coded, this parameter specifies the value of 
the index to be used in the VCCPTIT to find the operational 
characteristics of the VC. 


When TYPE=SWITCHED is coded, this parameter specifies: 


e For an incoming call, the value of the index to be used in the 
VCCPTIT to find the operational characteristics of the VC. 


e For a call request, the default value of the index to be used 
in the VCCPTIT to find the operational characteristics of the 
VC. The default value is used when the XX field of the 
"DIALNO=" operand of the PATH macro instruction is equal to 00. 


The valid range of values is from 1 te 19. The specified index 
must have been defined in a previous X25VCCPT macro, 


LLC=licn 


When TYPE=PERMANENT is coded, this parameter specifies the type of 
LLC used on this VC. No default value is given in this macro. The 
llcn suboperand can be PCNEO or PSH. 


e PCNEO means that the permanent virtual circuits are connected 
to non-SNA X.25 DTEs that do not support the interrupt packets. 


e PSH means that the permanent virtual circuits are connected to 
the 5973-L02 NIA. A two-byte LLC header is added to each 
packet. 


When TYPE=SWITCHED is coded, this parameter specifies a default 
value to be used if the "LLCLIST=" operand of the "TYPE="" keyword 
is not coded. 7 


TYPE=PERMANENT / SWITCHED 


Indicates the type of virtual circuit used. PERMANENT is the 
default value. This parameter can be abbreviated with P or S. 


"OUFINDX=index" specifies the default value of the index to be used 
in the OUFTIT to build the FACILITY and USER fields for a Call 
Request packet used on this VC. The specified index must have been 
defined in a previous X250UFT macro. This operand is required only 
when TYPE=SWITCHED is coded. 


LLCLIST=(11c0,1l1c2,...) specifies a maximum of two LLCs that can be 
used on this switched virtual circuit. The llcn value can be PCNEO 
or PSH. This operand is valid only when TYPE=SWITCHED is coded. 
The default value is the LLC specified in the mandatory LLC 
operand. 
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CALL=IN/OUT/ INOUT 


Specifies the type of call to be used on this VC. The default 
value is IN. | 


This keyword is valid only with TYPE=SWITCHED and must .be 
consistent with the ''CALL="" parameters of the NCP's LINE macro 
instruction that refers to the corresponding UACB. 


NCPGRP=label /NEW 


This parameter is optional and specifies the label of the NCP GROUP 
macro where the actual VC is defined in the NCP stage 1 deck. You 
usually do not have to specify this value, in which case the name 
is chosen by the X25NPSI stage 1 generation. You may code this 
operand when you want to modify an existing generation without 
modifying the NCP labels. 


If a label is specified, a new NCP GROUP is created with this label 
as the name of the GROUP macro. 


If NEW is specified, a new NCP group is created. The name of this 
group is automatically built by the X25NPSI stage 1 generation. 


Note: One group for PVCs and one group for SVCs is opened at a 
time. If this parameter is omitted, the VC being defined will 
belong to the previously opened, leased, or switched group, 
whichever group has chosen the name. 


VACB=label 


This parameter is optional and specifies the label of the user's 
ACB normally chosen by the actual X25NPSI stage 1 generation. You 
may code this operand to prevent label duplication with other 
resource names in the same generation. 


X25LINE MACRO INSTRUCTION 


This macro instruction can be used instead of the K25VC macro | 
instruction. It has the same operands, except for the "LCN="' operand, 
which can have one value only. 


As is the case for the X25VC macro instruction, the X25LINE macro 
instructions must be coded in ascending order with reference to the 
value of the LCN operand. 


The label of this macro instruction is mandatory, and is used as the 
resource name for the corresponding NCP line. 


This macro instruction must be followed by one X25PU macro instruction 
which can be followed by X25LU macro instructions. The labels of the 
X25PU/X25LU macro instructions are mandatory and are the symbolic names 
of the corresponding SNA resources. 
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2 


| Name | Operation | Operands 
X25LINE LCN=number, 
VCCINDK=index, 
LLC=1 len 


[, TYPE={ SWITCHED , OUFINDX=index, LLCLIST=(11c0,11c2,...)}] 
{ PERMANENT } 


[,CALL={OUT }] 
{IN } 
{ INOUT} 


[ NCPGRP={ label} ] 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| {NEW } 
| 


[ ,VACB=LABEL] 


atte erence) care tcc aerated Secees! ACe elAre e NOSOEOt SD eer Ret eet EES eee ert ee Sa en ee eee | 


Symbol 
This is mandatory and will be the label of the corresponding LINE 


macro instruction in the NCP deck and, therefore, the symbolic name 
of this SNA resource. 


LCN=number 
This parameter specifies the logical channel number of the virtual 
circuit being defined. This value is coded in decimal notation, 


and its valid range is from 0 to 255. For the remaining 
parameters, please refer to the preceding X25VC macro instruction. 


X25PU MACRO INSTRUCTION 
This macro instruction defines the PU attached to the line defined in 


the previous X25LINE macro instruction. The keyword operands are the 
same as in the NCP PU macro instruction. 


| Name | Operation | Operands | 
| symbol | X25PU | Same as in the NCP PU macro 


| | | (*) See note below 
De es ae eae ache ge Sete ke eet eee a eh ak ee ee Re ed 


A maximum of 500 such macros can be coded in an X.25 stage 1 deck. A 
SERVICE macro instruction is generated if necessary. 
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For both this and the following X25LU macro instruction, refer to the 
ACF/NCP/VS Release 2.1 Installation, SC30-3142. 

X25LU MACRO INSTRUCTION 

This macro instruction defines one of the LUs attached to the PU defined 


in the previous X25PU macro instruction. The keyword operands are the 
same as those of the NCP LU macro instruction. 


| Name | Operation | | Operands | 
| symbol | X25LU | Same as in the NCP LU macro | 


| | | (*) See note below | | 
DE Ne ee ace eae hg eae he oe a es 
A maximum of 4095 such macros can be coded in an X.25 stage 1 deck. 


Note: (DOS restriction): Only the first 8 characters of the keyword 
operand are transmitted to the NCP's system generation. The following 
message 


IFZ089 SETC OPERAND TOO LONG 


will appear each time a keyword value exceeds 8 characters. 


X25END MACRO INSTRUCTION 
This macro instruction ends the user's system generation. 


| Name | Operation | Operands | | 
| symbol | X25END | [INCPRFX={prefix}] | 
pO — ” 
| | | {,NCPSTG1={name }] | 
| | | {NONE } | 
| | | {X25NCP} | 


| | ae — | 


a222 


al ee Mae ee eee eee ek wee ee me a Renee ge eee 
| Name | Operation | Operands | 
eileen ral le prasad eA 
|, LSTUACB={NO }] 

{YES } ] 


[ ,X25VTAM={NO ] 
{YES} 


[,SCANCTL=....] 

[ ,HSPDSEL=.... ] 

[,INCL2HI={name }] 
{X25HIT} 
{X25L01} 


[,INCINIT={name }] 
{X25INI} 


[,ORDL2LO={name  }] (OS/VS only) 
{X25L00} 


[,ORDL2HI={name }] (OS/VS only) 
{X25HIO} 


[,ORDINIT={name }] (OS/VS only) 


{X25 INO} 
ce a ae ae Sa a rece a ee es ee 


| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
4. 
| : : [, INCL2LO={name }] | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 
| | | | 


INCPRFX=prefix/X.25 


Specifies the 1 to 5 characters used as prefix to give names to the 
member created by this assembly in the MACLIB. The default value 
is X25. The first character must be alphabetic, with the exception 
of $. 


NCPSTG1=name/NONE/X25NCP 


Specifies the name of the member stored in the MACLIB that will 
contain the frame of the NCP macros corresponding to the X25NPSI 
generation. The GROUP, LINE, PU, LU, and GENEND macros are punched 
in this member file. Even when you do not plan to use this 
facility, it is recommended that you code this operand to get a 
list of the NCP macros with the appropriate names, mainly the label 
of the GROUP macros and the value to code in the UACB operand of 
the LINE macros. When NONE is coded, no skeleton of the NCP macros 
is created. Therefore, you should provide these macros yourself. 


LSTUACB=NO/YES 


Specifies whether the X25NPSI UACBs inserted in the NCP by COPY 
SRCLO during the first assembly of the NCP's stage 2 will be ended 
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by the LASTUACB macro punched by this assembly. When NO is coded, 
a user other than an X25NPSI user must supply the LASTUACB macro, 
in which case this other user must insert his UACBs after those of 
X25NPSI. The default value is YES and must be used when no other 
user code is included in the NCP, through the user-written DLC, 
Customization Facility. Otherwise, only one user must supply the 
LASTUACB macro instruction. 


X25VTAM=NO/YES 


Specifies whether VTAM has been modified to accept the LINEADD=NONE 
and LINEAUT=YES operands of the GROUP macro. If not, the 
ADDRESS=NONE and AUTO=YES operands are generated in all the LINE 
macros describing virtual circuits. 


SCANCTL= HSPDSEL= 


These operands are optionally coded. Their contents are reproduced 
without checking in the GENEND statement of the member coded in 
the NCPSTG1 operand of the X25END macro. 


All the other operands are the same as in the GENEND macro in the 
corresponding NCP stage 1 generation. The default names are indicated 
in capital letters when INCPRFX is not coded. When INCPRFX is coded, 
the default names are prefixed by the user-supplied prefix. 


This macro closes the X25NPSI generation, prepares the JCL to set all 
the defined members in this macro in the MACLIB, and displays the 
information to be used for the NCP definition: 


: Group names, such as labels of the NCP GROUP macros for X25NPSI. 


ad UVACB names to be used in the UACB operands of the NCP LINE macros 
for X.25 lines. 


: Values to code in the keyword parameters of the NCP macros (BUILD, 
GROUP, GENEND). 


THE OPTIONAL GENEND MACRO INTRUCTION 


Skip this section if you have no other product inserted in your NCP with 
the Customization facility, such as the Network Terminal Option (NTO), 
or an Airlines Control Program. 


This macro instruction belongs to the SYS1.GEN3705XK library. Its 
purpose is to punch a GENEND statement for NCP stage 1, during X25NPSI 
stage 1. The resulting GENEND statement will contain (in a concatenated 
format) the parameters you have specified in the GENEND macro 
instruction for the NTO or the Airlines Control Program, plus those 
parameters particular to K25NPSI. 
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Note 1: When coded, the optional GENEND macro must be placed before 
X25END. 


| Note 2: Moreover, the first statement of the X.25 stage 1 input deck 
must be: 


COPY XGENEND 
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Example: 


If another product, using the Customization facility, must be inserted 
in the X25NPSI stage 1 generation sample and requires the following 
GENEND macro: 


GENEND INIT=USRINIT, INCINIT=USRINI, ------ 


This macro must be inserted in the X.25 stage 1 deck after the last 
X25VC macro and before the X25END macro: 


X25VC === 
GENEND —INIT=USRINIT, INCINIT=USRINI, 
X25END —s_------- 


Then the resulting GENEND macro will be prepared by the X.25 generation 
as follows and must be inserted in the NCP deck: 


GENEND INIT=(USRINIT, BALINIMD) , INCINIT=(USRINI ,DOLINI),--- 
THE IFQALIGN MACRO INSTRUCTION (DOS ONLY) 
The purpose of this macro is to make easier the process of the three 
steps of the NCP Generation Stage 3, which consists of 3 successive link 
edits. The operator is prompted after the first and second link edit to 
enter the "HICORE" value given by the previous link edit. This process 


is used to align the X.25 NPSI code on a 2K boundary. 


To use this facility, code this macro without any operand after the 
GENEND macro and before the END Statement in the NCP Stage 1 deck. 
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SUMMARY OF OPERANDS FOR X.25 MACROS THAT DESCRIBE THE NETWORK 


| OPERANDS 


| 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


ADDRESS 
CALL 
CSBTYPE 
FRMLGTH 
LCN 
LCGDEF 
LLC 
MACB 

MW INDOW 
NCPGRP 
NETTYPE 
NRZI 
OUF INDX 
PROTCOL 
RETRYCT 
RETRYTO 
RETVCCT 
RETVCTO 
SPEED 
STATION 
TYPE 
VACB 
VCCINDX 


| STAGE 1 MACRO INSTRUCTIONS | MACRO INSTRUCTIONS — | 


| X25BUILD | X25NET | X25MCH | X25VC | Used-in stage 2 | 
¥ BAK2MCH 

BAK2VC 

BAK2MCH 
BAK2MCH | 
BAK2VC 

BAK2MCH 

BAK2VC 

BAK2MCH 
BAK2MCH 
BAK2MCH , BAK2VC 
BAK2NET 


| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| 
| BAK2MCH | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 


© 


BAK2VC 
BAK2MCH 
BAK2MCH 
BAK2MCH 
BAK2VC 
BAK2VC 

NCP MACROS 
BAK2MCH 
BAK2VC 
BAK2VC 


| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| 0 | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | BAK2VC 


0 


ee ere EEE Ser [2Peeai ee Oy ier ec EreeeeraesE Me) Pee ew Rennie CCS! Meee ERO Ree as) OM rater te Oene PLES me eae TEER Ne Ae NET 


* Indicates macros in which the operand is described. 
0 Indicates macros in which the operand can be coded. 
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X25NPSI STAGE 1 SAMPLE GENERATION 


aleatenlealsntanteate ste mlontontcalants ats alaatonlantsnts mtoalsatealwcteatsatsalsalselaulantantantsatsalantentaatentaalealsalsntanlsnlsntaatasntaontamtasntasmlantar alas nla nlasatomts ntoataclsatsalsntanlantsntsnlsatsatante 
OO IV EDV GV EDV FV CD IV GV SD IV GV GB FH FIV AV CV IV EE FV FB AV EH GV FS FH FV GV IV IV EB FE GV FV IV GB AVIV ER GE GH GH EV IV IE IV FD ID IV IT IY FV EB IY GE ID GH FE FD FV GU AV GY EH ED FD CH ED EL CD OD 


GENERATION OF THE X.25 BLOCKS WITHIN NCP 


ve -1 NETWORK 
¥ -2 MCHS 
¥ -1 PVC AND 7 SVC'S FOR EACH MCH 


FRED FL AD ID IE ED GD IE GE GD GL AT AV GR IRAE GL IE EDEL EE ER AE EN ARAN AU GN AE OR GE AN GR AT GN AN OD AN AN AN IR EN ERAN IN GN IR EV EDIE AL ET IN IE EL AN AR AT AN AN OR ER EN AR AN CR ER OR EL AN 


ole 
PAY 


wee STAGE 1 INPUT 

NEOGENE X25BUILD MACLIB=MAC71, X.25 STAGE 2 OUTPUT 
JOBCARD=MULTI, 
QUALIFY=VTAM, 


SRCPRFX=D01, PREFIX FOR BLOCK MEMBERS IN VTAM.MAC71 


TYPSYS=0S, 
MCHCNT=2 
TRANSPAC X25NET NETTYPE=1 , CPHINDX=3 , OUHINDX=3 
X25VCCPT INDEX=1, 
MAXPKTL=128, 
VW INDOW=3 
X25VCCPT INDEX=3, 
MAXPKTL=128, 
VW INDOW=2 
X250UFT INDEX=1, 
USRFILD=12141618 
X250UFT INDEX=2, 
OPTFACL=0302 
X250UFT INDEX=3, 
OPTFACL=03021202, 
USRFILD=123456 
weve EFTRST MCH 
X25MCH CSBTYPE=3, 
ADDRESS=(024 ,025), 
LCGDEF=0 (7), 
FRMLGTH=131, 
MWINDOW=5 , 
STATION=DTE , 
SPEED=9600 
X25LCG LCGN=0 
XL024000 X25LINE LCN=0, 
VCCINDX=1, 
LLC=PCNEO, 
TYPE=P 


XP024000 X25PU PUTYPE=1 , ADDR=01 ,MAXDATA=261,VPACING=(2,1), 


PACING=(1,1) 

XU024000  X25LU LOCADDR=0 
X25VC LCN=(1,7), 

VCCINDX=1, 

OUFINDX=1, 

LLC=PCNEO, 

CALL=INOUT, 

LLCLIST=(PCNEO ,PSH), 


Vr OS PK 


vasa! 


ro 


MK PK OS 


SS 
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F-26452 


- TYPE=SWITCHED 
Witinivt SECOND MCH 
X25MCH CSBTYPE=2, 
ADDRESS=(0A8,0A9), 
LCGDEF=0(7), 
FRMLGTH=131, 
STATION=DTE, 
SPEED=9600, 
MWINDOW=3 
X25LCG LCGN=0 
X25VC LCN=0, 
VCCINDX=1, 
TYPE=PERMANENT, 
LLC=PCNEO 
X25VC LCN=(1,2), 
VCCINDX=1, 
OUFINDX=1, 
LLCLIST=(PCNEO, PSH), 
LLC=PCNEO, 
TYPE=SWITCHED 
X25VC LCN=3, 
VCCINDX=1, 
CALL=INOUT, 
OUFINDX=1, 
LLC=PCNEO, 
LLCLIST=(PCNEO), 
TYPE=SWITCHED 
X25VC LCN=4, 
VCCINDX=1, 
CALL=INOUT, 
OUFINDX=1, 
LLC=PSH, 
LLCLIST=(PCNEO , PSH), 
TYPE=SWITCHED 
X25VC LCN=5, 
VCCINDX=3, 
CALL=OUT, 
OUFINDX=3, 
LLC=PSH, 
LLCLIST=(PCNEO, PSH), 
TYPE=SWITCHED 
X25VC LCN=6, 
VCCINDX=1, 
CALL=OUT, 
OUF INDX=2 , 
LLC=PCNEO , 
LLCLIST=(PCNEO, PSH), 
TYPE=SWITCHED 
X25VC LCN=7, 
VCCINDX=1, 
CALL=OUT, 
OUFINDX=1, 
LLC=PCNEO, 
LLCLIST=(PCNEO, PSH), 
TYPE=SWITCHED | 
X25END INCPRFX=D01, X 


PS PS PG OS PS OS 


mS PS PS 


PS DS PS PS PG OPS PS PS PS PS DOS PS PG PSPS PS DS OS PS PS PS PS PS PS PS PG PS PS PS 


PG PS PS OS OS OPS 


X25NPSI Program Description and Operation Manual 5-27 


END 


NCPSTG1=DO1INX25, 
X25VTAM=NO 


X25NPSI Stage 1 Sample Output for OS/VS 


//DO1TBL JOB’ (LGDE, 


// 370Y) 


, FERR , TYPRUN=HOLD , CLASS=L 


//S1 EXEC PGM=IEBUPDTE , PARM=NEW 
//SYSPRINT DD SYSOUT=A 


/ /SYSUT2 


DD DSN=VTAM.MAC71,DISP=SHR 


//SYSIN DD DATA 
./ ADD NAME=DO1TBL 


«f 
X25$MKB 
TRANSPAC 
X25N1C1 
X25N1C3 
X25N101 
X25N102 


X25N103 
X25KM024 


X25K0240 


XB024000 


XB024001 


XB024002 


XB024003 


XB024004 


XB024005 


NUMBER NEW 1=10000 , INCR=1000 


BAK2INIT AVTN=BALSAVT , LLCTN=BALSLLC , XPARENT=1 , SARL=1 , MCHCNT=2 

BAK2NET NETTYPE=1 ,CPTITN=X25N1C ,CPTITL=4, OUFTITN=X25N10, OUFTIT* 
L=4 

BAK2VCPT DATAPTY=LOW, INDEX=1 , MAXPKTL=128 , PKTSEQ=0 , VWWINDOW=3 , OU* 
TSLOW=0 , INSLOWY=2 , INSLOWX=16 

BAK2VCPT DATAPTY=LOW , INDEX=3 "-MAXPKTL=128 , PRTSEQ=0 , WWINDOW=2 , OU* 
TSLOW=0 , INSLOWY=2 , INSLOWX=16 

BAK20UFT INDEX=1,FACL=0 , DATL=4 , VALUE=12141618 

BAK20UFT INDEX=2 , FACL=2 , DATL=0 , VALUE=0302 

BAK20UFT INDEX=3 , FACL=4 , DATL=3 , VALUE=12020302123456 

BAK2MCH NRZI=NO,STATION=DTE , PROTCOL=LAP , MWINDOW=5 , FRMLGTH=131* 
, RETRYCT=7 , RETRYTO=1 , ACBXN=X25A024X , ACBRN=X25A024R , LIQN=* 
X25Q024 ,MCHNO=1 , CSBTYPE=3 , VCGATL=1 , VCGATN=X25KG024 , VCBAT* 
N=X25KV024 , VCBATL=8 , PLPOUEP=BALPLPO , VOMINEP=BALVCIE1 , GCB* 
N=XNET 11, RLINADD=025 , XLINADD=024 , VCSCNB=30 , XPRTIEP=BALPC* 
A2 ,XPRTOEP=BALPCA3 , XSLUBN=X25KS024 , STATSEP=BALNASTA 

BAK2LCG LCGN=0 , LCCNT=8 

BAK2VC TYPE=P , DSTNODE=BNN , VCCINAM=X25N1C1, RETVCTO=40 , RETVCCT=0* 
» LLC=0 , LON=0 , VCC INDX=1 , OUF INDX=0 , VCMOUEP= BALVCOF1, LLCOUT* 
K=BALLCOUT, PLP INAC=BALPLPI1,SLUBN=XS024000 , PLPINEP=BALPL* 
PT , VACBN=XA024000 , GCBN=X25P024A , PKTMODL=8 

BAK2VC TYPE=S , DSTNODE=BNN , VCC INAM=X25N1C1, OUF INAM=X25N101, CALL* 
=INOUT , RETVCTO=40 , RETVCCT=0 , LLC=0 , LLCLIST=(0,2),LCN=1, * 
VCCINDX=1 , OUF INDX=1 , VCMOUEP=BALVCOF 1 , LLCOUTK=BALLCOUT , PL* 
PINAC=BALPLPI1 , SLUBN=XS024001 , PLPINEP=BALPLPI , VACBN=XA02* 
4001 ,GCBN=X25S024B , PKTMODL=8 

BAK2VC TYPE=S , DSTNODE=BNN , VCC INAM=X25N1C1,OUFINAM=X25N101 , CALL* 
=INOUT , RETVCTO=40 , RETVCCT=0 , LLC=0 , LLCLIST=(0,2),LCN=2, * 
VCC INDX=1 , OUF INDX=1 , VCMOUEP=BALVCOF 1 , LLCOUTK=BALLCOUT , PL* 
PINAC=BALPLPI1 , SLUBN=XS024002 , PLPINEP=BALPLPI , VACBN=XA02* 
4002 ,GCBN=X25S024B , PKTMODL=8 


BAK2VC TYPE=S , DSTNODE=BNN , VCC INAM=X25N1C1 , OUF TINAM=X25N101 , CALL* 


=INOUT , RETVCTO=40 , RETVCCT=0 , LLC=0 , LLCLIST=(0,2),LCN=3, * 
VCCINDX=1 , OUFINDX=1 , VCMOUEP=BALVCOF1 , LLCOUTK=BALLCOUT , PL* 
PINAC=BALPLPI1 , SLUBN=XS024003 , PLPINEP=BALPLPI , VACBN=XA02* 

4003 ,GCBN=X25S024B , PRTMODL=8 
BAK2VC TYPE=S , DSTNODE=BNN , VCC INAM=X25N1C1 , OUF INAM=X25N101, CALL* 
=INOUT , RETVCTO=40 , RETVCCT=0 , LLC=0 , LLCLIST=(0,2),LCN=4, * 
~ VCCINDX=1 ,OUF INDX=1 , VCMOUEP=BALVCOF 1 , LLCOUTK=BALLCOUT,, PL* 
PINAC=BALPLPI1,SLUBN=XS024004 , PLPINEP=BALPLPI , VACBN=XA02* 

4004 ,GCBN=X25S024B , PKTMODL=8 
BAK2VC TYPE=S , DSTNODE=BNN , VCC INAM=X25N1C1 , OUF INAM=X25N101, CALL* 
=INOUT , RETVCTO=40 , RETVCCT=0 , LLC=0 , LLGLIST=(0,2),LCN=5, * 
VCC INDX=1 , OUFINDX=1 , VCMOUEP=BALVCOF 1 , LLCOUTK=BALLCOUT , PL* 
PINAC=BALPLPI1,SLUBN=XS024005 , PLPINEP=BALPLPI , VACBN=XA02* 
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XB024006 


XB024007 


X25KMOA8 


X25KOA80 


XBOA8000 


XBOA8001 


XBOA8002 


XBOA8003 


XBOA8004 


XBOA8005 


XBOA8006 


XBOA8007 


4005 ,GCBN=X25S024B, PKTMODL=8. 

BAK2VC TYPE=S , DSTNODE=BNN , VCCINAM=X25N1C1,OUFINAM=X25N101, CALL* 
=INOUT , RETVCTO=40 , RETVCCT=0 , LLC=0 LLCLIST=(0, 2),LCN=6, * 
VCCINDX=1 , OUFINDX=1 , VCMOUEP=BALVCOF 1, LLCOUTK=BALLCOUT,, PL* 
PINAC=BALPLPI1 , SLUBN=XS024006 , PLPINEP=BALPLPI , VACBN=XA02* 
4006 ,GCBN=X25S024B , PKTMODL=8 

BAK2VC TYPE=S , DSTNODE=BNN , VCCINAM=K25N1C1 , OUFINAM=X25N101, CALL* 
=INOUT , RETVCTO= 40 , RETVCCT=0 , LLC=0 LLCLIST=(0, 2),LCN=7, * 
VCCINDX=1 , OUFINDX=1 , VCMOUEP=BALVCOF 1 , LLCOUTK=BALLCOUT , PL* 
PINAC=BALPLPI1 , SLUBN=XS024007 , PLPINEP=BALPLPI , VACBN=XA02* 
4007 ,GCBN=X25S024B , PKTMODL=8 

BAK2MCH NRZI=NO,STATION=DTE , PROTCOL=LAP , MW INDOW=3 , FRMLGTH=131* 
, RETRYCT=7 , RETRYTO=1 , ACBXN=X25A0A8X , ACBRN=X25A0A8R, LIQN=* 
X25Q0A8 , MCHNO=2 , CSBTYPE=2 , VCGATL=1 , VCGATN=X25KGOA8 , VCBAT* 
N=X25KVOA8 , VCBATL=8 , PLPOUEP=BALPLPO , VCMINEP=BALVCIE1 ,GCB*. 
N=XNET11, RLINADD=0A9 , XLINADD=0A8 , VCSCNB=30 , XPRTIEP=BALPC* 
A2 ,XPRTOEP=BALPCA3 , XSLUBN=X25KSOA8 , STATSEP=BALNASTA 

BAK2LCG LCGN=0, LCCNT=8 

BAK2VC TYPE=P , DSTNODE=BNN , VCCINAM=X25N1C1, RETVCTO=40 , RETVCCT=0* 
, LLC=0 , LCN=0 , VCCINDX=1 , OUFINDX=0 , VCMOUEP=BALVCOF 1 , LLCOUT* 
K=BALLCOUT , PLPINAC=BALPLPI 1 , SLUBN=XS0A8000 , PLPINEP=BALPL* 
PI , VACBN=XA0A8000 , GCBN=X25POA8A, PKTMODL=8 

BAK2VC TYPE=S , DSTNODE=BNN , VCCINAM=X25N1C1 , OUFINAM=X25N101, CALL* 
=IN, RETVCTO=40 , RETVCCT=0 , LLC=0 , LLCLIST=(0, 2) , LCN=1, ve 
VCCINDX=1 , OUFINDX=1 , VCMOUEP=BALVCOF1,LLCOUTK=BALLCOUT, * 
PLPINAC=BALPLPI 1, SLUBN=XS0A8001, PLPINEP=BALPLPI , ve 
VACBN=XA0A8001 , GCBN=X25SOA8B , PKTMODL=8 | 

BAK2VC TYPE=S , DSTNODE=BNN, VCCINAM=X25N1C1 , OUFINAM=X25N101, CALL* 
=IN, RETVCTO=40 , RETVCCT=0 , LLC=0, LLCLIST=(0,2),LCN=2, * 
VCCINDX=1 , OUFINDX=1 , VCMOUEP=BALVCOF1, LLCOUTK=BALLCOUT, * 
PLPINAC=BALPLPI 1, SLUBN=XS0A8002, PLPINEP=BALPLPI , ve 
VACBN=XA0A8002 , GCBN=X25SOA8B , PKTMODL=8 | : 

BAK2VC TYPE=S , DSTNODE=BNN , VCCINAM=X25N1C1, OUFINAM=X25N101, CALL* 
=INOUT , RETVCTO=40 , RETVCCT=0 , LLC=0 , LLCLIST=(0) , LCN=3, we 
VCCINDX=1 , OUFINDX=1 , VCMOUEP=BALVCOF1,LLCOUTK=BALLCOUT, * 
PLPINAC=BALPLPI 1, SLUBN=XS0A8003, PLPINEP=BALPLPI , ve 
VACBN=XA0A8003 , GCBN=X25SOA8B , PKTMODL=8 

BAK2VC TYPE=S , DSTNODE=BNN , VCCINAM=X25N1C1, OUF INAM=X25N101,CALL* 
=INOUT , RETVCTO=40 , RETVCCT=0 , LLC=2 , LLCLIST=(0, 2) , LCN=4, VC* 
CINDX=1 , OUFINDX=1 , VCMOUEP=BALVCOF 1 , LLCOUTK=BALLCOUT , PLPI* 
NAC=BALPLPI 1, SLUBN=XSO0A8004 , PLPINEP=BALPLPI , VACBN=XAOA80* 
04, GCBN=X25SOA8B, PKTMODL=8 | 

BAK2VC TYPE=S ,DSTNODE= BNN, VCC INAM=X25N1C3 ,OUFINAM=X25N103,CALL* 
=OUT , RETVCTO=40 , RETVCCT=0, LLC=2 , LLCLIST=(0,2),LCN=5 , VCCI* 
NDX=3 , OUFINDX=3 , VCMOUEP=BALVCOF 1 , LLCOUTK=BALLCOUT , PLPINA* 
C=BALPLPI 1 ,SLUBN=XS0A8005 , PLPINEP=BALPLPI , VACBN=XA0A8005* 
,GCBN=X25S0A8B,PKTMODL=8 

BAK2VC TYPE=S , DSTNODE=BNN , VCCINAM=X25N1C1,OUF INAM=X25N102 , CALL* 
=OQUT , RETVCTO=40 , RETVCCT=0 , LLC=0 , LLCLIST=(0,2) , LCN=6, VCCI* 
NDX=1, OUFINDX=2 , VCMOUEP=BALVCOF 1 , LLCOUTK=BALLCOUT , PLPINA* 

C=BALPLPI 1, SLUBN=XS0A8006 , PLPINEP=BALPLPI , VACBN=XAOA8006* 
, GCBN=X25 SOA8B , PKTMODL=8 

BAK2VC TYPE=S , DSTNODE=BNN ,, VCCINAM=X25N1C1,OUFINAM=X25N101, CALL* 
=OUT , RETVCTO=40 , RETVCCT=0 , LLC=0 LLCLIST=(0, 2), LCN=7, we 
VCCINDX=1 , OUFINDX=1 , VCMOUEP=BALVCOF 1, LLCOUTK=BALLCOUT, we 
PLPINAC=BALPLPI 1, SLUBN=XS0A8007 , PLPINEP=BALPLPI , ve 


VACBN=XA0A8007 , GCBN=X25SOA8B , PKTMODL=8 
SSRCLO CSECT 
/* 
//DO1BLK JOB’ (LGDE, 
// 370Y),FERR,TYPRUN=HOLD , CLASS=L 
//S2 EXEC PGM=IEBUPDTE , PARM=NEW 
//SYSPRINT DD SYSOUT=A 
//SYSUT2 DD DSN=VTAM.MAC71,DISP=SHR 
//SYSIN DD DATA 

./ ADD NAME=D01BLK 


af NUMBER NEW 1=10000 , INCR=1000 
BAK2END LSTUACB=YES , LLCOEP=(BALPCAO , BALPCA1) , LLC1EP=(BALPCAO , B* 
ALPCA1) , LLC2EP=(BALPSHO, BALPSHI ) 
SSRCHI CSECT 
/ ¥ 
//DO1LOI JOB’ (LGDE, 


// 370Y),FERR,TYPRUN=HOLD , CLASS=L 
//S3 EXEC PGM=IEBUPDTE , PARM=NEW 
//SYSPRINT DD SYSOUT=A 
//SYSUT2 DD DSN=VTAM.MAC71,DISP=SHR 
//SYSIN DD DATA 
./ ADD NAME=D01LOI 
./ NUMBER NEW1=10000 , INCR=1000 
INCLUDE ULIB(BALNASME) 
//DO1HII JOB (LGDE, 
// 370Y),FERR,TYPRUN=HOLD , CLASS=L 
//S4 EXEC PGM=IEBUPDTE , PARM=NEW 
//SYSPRINT DD SYSOUT=A 
//SYSUT2 DD DSN=VTAM.MAC71,DISP=SHR 
//SYSIN DD DATA 
./ ADD NAME=DO1HII 


ay A NUMBER NEW 1=10000 , INCR=1000 


ale 
cA’ 


INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 


//DOLINI 


ULIB (BALNASM4 ) 
ULIB (BALL2TMB) 
ULIB (BALSTAM8 ) 
ULIB(BALPLPMS ) 
ULIB(BALVCIM6) 
ULIB(BALVCIMC) 
ULIB(BALVCOMA ) 
ULIB(BALPCNMQ ) 
ULIB(BALUSIMF) 
ULIB(BALPSHM7) 
ULIB(BALLAPM1) 
ULIB(BALLAPN1) 


JOB (LGDE, 


// 370Y),FERR,TYPRUN=HOLD , CLASS=L 
//S5 EXEC PGM=IEBUPDTE , PARM=NEW 
//SYSPRINT DD SYSOUT=A 
//SYSUT2 DD DSN=VTAM.MAC71,DISP=SHR 
//SYSIN DD DATA 
./ ADD NAME=DO1INI 
AY NUMBER NEW 1=10000 , INCR=1000 
INCLUDE ULIB(BALINIMD) 
/ w 
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//DO1L00 JOB (LGDE, 
// 370Y),FERR,TYPRUN=HOLD , CLASS=L 
//S6 EXEC PGM=IEBUPDTE , PARM=NEW 
//SYSPRINT DD SYSOUT=A 
//SYSUT2 DD DSN=VTAM.MAC71,DISP=SHR 
//SYSIN DD DATA 
./ ADD NAME=D01L00 
af NUMBER 
ORDER BALNASME 
/ w 
//DO1HIO JOB (LGDE, 
// 370Y),FERR,TYPRUN=HOLD , CLASS=L 
//S7 EXEC PGM=IEBUPDTE , PARM=NEW 
//SYSPRINT DD SYSOUT=A 
//SYSUT2 DD DSN=VTAM.MAC71,DISP=SHR 
//SYSIN DD DATA 
./ ADD NAME=D01HIO 


NEW1=10000 , INCR=1000 


-/ 

ORDER 
ORDER 
ORDER 
ORDER 
ORDER 
ORDER 
ORDER 
ORDER 
ORDER 
ORDER 
ORDER 
ORDER 
ORDER 
ORDER 
ORDER 
ORDER 


NUMBER 
BALTICK 
BALNASM4 
BALSTAM8 
BALLCIN 
BALL2TMB 
BALPLPM5 
BALVCIM6 
BALVCIMC 
BALVCOMA 
BALPCNM9 
BALUSY 
BALUSA 
BALUSB 
BALPSHM7 
BALLAPZ2 
BALLAPZ3 


NEW1=10000 , INCR=1000 


/ w 
//DO1INO JOB (LGDE, 
// 370Y),FERR,TYPRUN=HOLD , CLASS=L 
//58 EXEC PGM=IEBUPDTE , PARM=NEW 
//SYSPRINT DD SYSOUT=A 
//SYSUT2 DD DSN=VTAM.MAC71,DISP=SHR 
//SYSIN DD DATA | 
./ ADD NAME=D0O1INO 
af NUMBER 
ORDER BALINIMD 
/ w 
//DO1INX.25 JOB (LGDE, 
// 370Y),FERR,TYPRUN=HOLD , CLASS=L 
//S9 EXEC PGM=IEBUPDTE , PARM=NEW 
//SYSPRINT DD SYSOUT=A 
//SYSUT2 DD DSN=VTAM.MAC71,DISP=SHR 
//SYSIN DD DATA 
./ ADD NAME=DO1INX.25 
sf NUMBER NEW1=10000 , INCR=1000 
XNET11 GROUP LNCTL=SDLC , LEVEL2=BALNAML2 , LEVEL3=BALNAML3 , USERID=(56689* 
81,BALMBDT) , LEVEL5=NCP , TIMER=(BALLAP4 , BALLAP4 , BALLAP4 , BA* 


NEW1=10000 , INCR=1000 


XL024 


XP024 
XU024 
XLOA8 


XPOA8 
XUO0A8 
X25P024A 


XL024000 


XP024000 
XU024000 
X25POA8A 


XLOA8000 


XPOA8000 
XU0A8000 
X25SOA8B 


XLOA8007 
XP0A8007 
XLOA8006 
XP0A8006 
XLOA8005 
XPOA8005 
XLOA8004 
XPOA8004 
XL0A8003 
XPOA8003 
XLOA8002 
XPOA8002 
XLOA8001 
XPOA8001 
X25S024B 


XL024007 
XP024007 
XL024006 
XP024006 
XL024005 
XP024005 
XL024004 
XP024004 
XL024003 


LLAP4) , XIO=(BALNAMXL, BALNAMXS , BALNAMXI , BALNAMXK) , DIAL=NO 
LINE UACB=(X25A024X,X25A024R) , ADDRESS=(024,025) , SPEED=9600 
SERVICE ORDER=XP024 
PU ADDR=01 ,MAXDATA=261 , PUTYPE=1 
LU LOCADDR=0 
LINE UACB=(X25A0A8X, X25A0A8R) , ADDRESS=(0A8 , 0A9) , SPEED=9600 
SERVICE ORDER=XPOA8 


PU ADDR=01 , MAXDATA=261 , PUTYPE=1 

LU LOCADDR=0 

GROUP LNCTL=SDLC , LEVEL2=BALNAVL2 , LEVEL3=BALNAVL3 , LEVEL5=NCP , US* 
ERID=(5668981,BALPBDT) , TIMER=(BALNATER, BALNATRA, * 


BALNATST , BALNATLS) , XIO=(BALNAVXL, BALNAVXS , BALNAVXI , BALNA* 
VXK) , DIAL=NO 

LINE ADDRESS=NONE ,UACB=XA024000 

SERVICE ORDER=XP024000 

PU ADDR=01,MAXDATA=261 , PACING=(1,1) , VPACING=(2,1) , PUTYPE=1 

LU LOCADDR=0 

GROUP LNCTL=SDLC , LEVEL2=BALNAVL2 , LEVEL3=BALNAVL3 , LEVEL5=NCP , US* 
ERID=(5668981,BALPBDT) , TIMER=(BALNATER, BALNATRA, te 
BALNATST , BALNATLS) , XIO=(BALNAVXL, BALNAVXS , BALNAVXI , BALNA* 
VXK) , DIAL=NO 

LINE ADDRESS=NONE , UACB=XA0A8000 

SERVICE ORDER=XP0A8000 


PU PUTYPE=1 , ADDR=01 , MAXDATA=261 , VPACING=(2,1), PACING=(1,1) 

LU LOCADDR=0 

GROUP LNCTL=SDLC , LEVEL2=BALNAVL2, LEVEL3=BALNAVL3, LEVEL5=NCP, Us* 
ERID=(5668981, BALSBDT), TIMER=(BALNATER, BALNATRA, 
BALNATST, BALNATLS) , XIO=(BALNAVXL , BALNAVXS , BALNAVXI , BALNA* 
VXK) , DIAL=YES | 

LINE CALL=OUT, ADDRESS=NONE , AUTO=YES , UACB=XA0A8007 

PU MAXLU=3 , PUTYPE=(1, 2) 

LINE CALL=OUT,ADDRESS=NONE , AUTO=YES, UACB=XA0A8006 

PU MAXLU=3 , PUTYPE=(1, 2) 

LINE CALL=OUT, ADDRESS=NONE , AUTO=YES , UACB=XA0A8005 

PU MAXLU=3 , PUTYPE=(1,2) 

LINE CALL=INOUT ,ADDRESS=NONE , AUTO=YES , UACB=XA0A8004 

PU MAXLU=3 , PUTYPE=(1,2) 

LINE CALL=INOUT,ADDRESS=NONE , AUTO=YES , UACB=XA0A8003 

PU MAXLU=3 , PUTYPE=(1, 2) 

LINE CALL=IN, ADDRESS=NONE , AUTO=YES , UACB=XA0A8002 

PU MAXLU=3 , PUTYPE=(1, 2) | 

LINE CALL=IN , ADDRESS=NONE , AUTO=YES , UACB=XA0A8001 

PU MAXLU=3 , PUTYPE=(1, 2) 

GROUP LNCTL=SDLC , LEVEL2=BALNAVL2 , LEVEL3=BALNAVL3 , LEVEL5=NCP , US* 
ERID=(5668981,BALSBDT) , TIMER=(BALNATER, BALNATRA, * 
BALNATST , BALNATLS ) , XIO=(BALNAVXL, BALNAVXS , BALNAVXI , BALNA* 
VXK) , DIAL=YES 

LINE CALL=INOUT,ADDRESS=NONE , AUTO=YES , UACB=XA024007 

PU MAXLU=3 , PUTYPE=(1,2) | 

LINE CALL=INOUT,ADDRESS=NONE , AUTO=YES , UACB=XA024006 

PU. MAXLU=3 , PUTYPE=(1,2) 

LINE CALL=INOUT; ADDRESS=NONE , AUTO=YES, UACB=KA024005 

PU MAXLU=3 , PUTYPE=(1,2) 

LINE CALL=INOUT, ADDRESS=NONE , AUTO=YES, UACB=XA024004 

PU MAXLU=3 , PUTYPE=(1,2) 

LINE 


CALL=INOUT » ADDRESS=NONE , AUTO=YES , VACB=XA024003 
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XP024003 PU  MAXLU=3,PUTYPE=(1,2) | 

XL024002 LINE CALL=INOUT,ADDRESS=NONE , AUTO=YES , UACB=XA024002 

XP024002 PU  MAXLU=3,PUTYPE=(1,2) os 

XL024001 LINE CALL=INOUT, ADDRESS=NONE , AUTO=YES , UACB=XA024001 

XP024001 PU  MAXLU=3,PUTYPE=(1,2) - | 

GENEND INIT=BALINIMD, INCINIT=DO1INI , INCL2HI=DO1HII , INCL2LO=D01* 
LOI , SRCHI=DO1BLK , SRCLO=DO1TBL , ORDL2LO=D01L00 , ORDL2HI=D01* 
HIO, ORDINIT=DO1INO, TMRTICK=BALTICK 
./ ENDUP 


/* 


NCP STAGE 1 SYSTEM GENERATION 

X25NPSI stage 1 will produce in the output an IEBUPDTE step containing 
the GROUP, LINE, PU, SERVICE, and LU macros that describe the X.25 
configuration in the NCP's stage 1 generation. 

RESOURCE NAMING CONVENTIONS 

The SNA resource names can be allocated by the X25NPSI system 
generation, or by the user through the X25LINE, X25PU, and X25LU macro 


instructions. 


All resource names built by X25NPSI stage 1 begin with the letter X. 
You should not use this letter for resources other than X.25 resources. 


More precisely, the prefixes used for the block names are: 


XA... For the UACBs of the VC (VUA) 
XB... For the VCBs 

».4 teen For the LKBs (LINE macro) 
XP... For the PUs (PU macro) 

XS... For the SLUBs 

KU aes For the LUs (LU macro) 

X25... For all other blocks 


The names allocated to the SNA resources by the X25NPSI stage 1 are 
built as follows: | 


1. For the MCH: 


XLxxx for the label of the LINE macro 
XPxxx for the label of the PU macro 
XUxxx for the label of the LU macro 


Where xxx is the line set address of the transmit leg. 
2. For the VC: 


XLxxxlcen for the label of the LINE macro 
XPxxxlcn for the label of the PU macro 
XUxxxlcen for the label of the LU macro 


Where xxx is the line set address of the transmit leg of the 
related MCH, and lcn the Logical channel number of the current VC 
in hexadecimal. 


Note: You should use the generated names, because they will simplify 
the identification of the X.25 resources in the host. 


X25NPSI uses macros to describe its control blocks during the first NCP 
stage 2 assembly. All these macros are prefixed with BAK2. As a 
consequence, no other user can utilize this prefix for the same purpose. 
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All the entry points within the X25NPSI code in the load module begin. 
with the prefix BAL. Therefore, no other user can utilize these three 
letters for the same purpose. | 


BUILD MACRO INSTRUCTION 


| Name | Operation | Operands | 
Se SS 
Rg | BUILD By ies tatacaie | 
| | | | | 
| | | [,MACLIB=dsname] | (OS only) | 
| | | | | 
| | | [,QUALIFY={NONE }] (OS only) | 
| | | {symbol} | 
| | : {SYS1_ } : 
| | | [,USERLIB=] (OS only) | 
| | | | 
| | | 


Ucn BU a ar ee 


These operands should agree with the same operands coded in the X25BUILD 
macro described previously in the "X25NPSI Stage 1 Generation Macro 
Description". Please refer to the description of the X25BUILD macro for 
more information. 


GROUP MACRO INSTRUCTION 


A new operand has been added to this macro instruction to identify the 
user and the entry of the Block Dump Table used to format the user's 


blocks. This operand is prepared by X25NPSI stage 1 with the 


appropriate value and should be used as is. 


USERID=(User Identification,Entry Label) | 


User Identification 


Specifies the user's identification, and consists of from 1 to 7 
alphanumeric characters. For IBM users, using the product number 
is recommended. For this X25NPSI, the identification used is 
5668-981. This identification is used by the system generation as 
a character constant to identify all the GCBs pertaining to the 
user. 


Entry Label 
Specifies the label of the Block Dump Table used by the modified 
formatted dump to edit and format the user's blocks. For X25NPSI, 


the following names are used: 
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TNL SN30-3213 (26 Feb 82) to SC30-3078-0 


BALMBDT Block Dump Table for MCHs 

BALPBDT Block Dump Table for PVCs 

BALSBDT Block Dump Table for SVCs 
Note: This operand will temporarily cause a WARNING message to be 
issued when VTAM loads the 3705 for the first time. 
LUDRPOOL MACRO INSTRUCTION 
This macro instruction must be included when the access method is 
ACF/VTAM, release 2 or higher, if there are switched virtual circuits 
defined in the system generation. 


LINE MACRO INSTRUCTION 


All the operands are correctly prepared by X25NPSI stage 1. 


PU MACRO INSTRUCTIONS 


| The SRT operand is not supported by X25NPSI. Default values for SRT are 
| fixed and equal to 32768 for counters contained in two bytes, and 256 

| for counters contained in one byte. (See the sections titled ''MCH's 

| RECMS for SNA Statistics" and "VC's RECMS for SNA Statistics" in Chapter 
| 9). 


PU Macro Instruction Associated with a Multichannel Link 


eg es ee ee eg eg 


| Name | Operation | Operands | 
| [symbol] | PU | ADDR=01, | 
| | | MAXDATA=261, | 
| | | PUTYPE=1, | 
| | | PUDR=NO | 


ADDR= 
Specifies the hexadecimal representation of the eight-bit address 
of the physical unit represented by this PU Macro. It must be 
coded 01. 

MAXDATA=261 
Specifies the maximum length of a PIU sent to a type 1 PU. 


PUTYPE= 


Specifies the type of physical unit constituting the SDLC station 
represented by this PU macro instruction. It must be coded 1. 
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PUDR=NO 


Specifies that dynamic reconfiguration is not allowed for this PU. 


PU Macro Instruction Associated with a Permanent Virtual Circuit 

Refer to the instructions in the ACF/NCP/VS Installation, S8C30-3142, for 

coding a PU macro instruction for a PU on a non-switched line. More 

information concerning certain parameters follows: 

° ANS=CONTINUE is significant only if it has been coded with the same 
value in the PU of the MCH. 


For LLC=PCNEO: 


° PUTYPE must be equal to 1. The PCNE simulates an LU associated with 
a type 1 PU. : 


° MAXDATA must be equal to or greater than the maximum size of the RUs 
sent by the application to the pseudo-LU in the NCP. 

For LLC=PSH: 

The MAXDATA parameter must reflect the PU characteristics of the SNA 

terminal attached to this PVC. . 

PU Macro Instruction Associated with a Switched Virtual Circuit 

Refer to the ACF/NCP/VS Installation, SC30-3142, for a dummy PU 

definition on a switched line. To define the actual PU to the access 


method, refer to the appropriate documentation. 


The ANS=STOP operand is required. 
LU MACRO INSTRUCTIONS 


LU Macro Instruction Associated with a Multichannel Link 


The LU associated with a multichannel link must never be activated. 


ss ee 


| Name | Operation | Operands 3 | 
| | | = 
| | ee | 
| [symbol] | LU | LOCADDR=0, | 
| | | ISTATUS=INACTIVE, | 
| | | LUDR=NO | 
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LOCADDR= 
Specifies the local address of the logical unit in decimal 
notation, and without leading zeros. It must be coded 0. 
ISTATUS=SINACTIVE 


Specifies to VTAM that this LU should not be activated after IPL. 


LUDR=NO 


Specifies that dynamic reconfiguration is not allowed on this LU. 


LU Macro Instruction Associated with a Permanent Virtual Circuit 

Refer to the instructions in the NCP Generation Manual for coding an LU 
on a non-switched line. For LLC=PCNEO, the "PACING=" keyword must be 
coded PACING=(1,1). This is the default value. For LLC=PCNEO, the 
"LOCADDR="" parameter must be coded 0. 


LU Macro Instruction Associated with a Switched Virtual Circuit 


This macro must be defined in accordance with the specific host access 
method documentation. 
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NCP STAGE 1 SAMPLE GENERATION 


The following is an NCP generation sample, corresponding to the 
previously presented X25NPSI stage 1 sample output where two 
multichannel links are defined. Six permanent virtual circuits are 
defined on the first multichannel link. One permanent virtual circuit 
and seven switched virtual circuits are defined on the second one. The 
terminals may be accessed through the two different multichannel links. 


BAKLOCAL PCCU CUADDR=0D0 , DUMPDS=DUMDSET , SUBAREA=2. 
BAKBUILD BUILD JOBCARD=MULTI , ASMXREF=SHORT, 
QUALIFY=VTAM, 


OBJQUAL=D1, REPLACE CG 
MACLIB=(MAC71,MAC3705X), X.25 SYSGEN OUT/X.25 MACROS 
USERLIB=0BJ71, X.25 OBJECT MODULES 
OBJLIB=DO10BJ, NCP STAGE2 OUTPUT 
LOADLIB=LNCP71, NCP LOAD MODULE 


UNIT=SYSDA, 
UT1=NCP70UT1, 
UT2=NCP70UT2, 
UT3=NCP70UT3, 
TYPGEN=NCP , 
CA=TYPE4 , CHANTYP=(TYPE4), 
MODEL=3705-2, 
MAXSUBA=7, 
SUBAREA=5, NCP SUBAREA = X'AOOO' 
MEMSIZE=256, 
BFRS=92, 
ANS=YES, 
ABEND=YES, 
TRACE=(YES,100), 
NEWNAME=D0 1GEN 

BAKSYSC SYSCNTRL OPTIONS=(STORDSP) 


P64 PS PS PG PS OS OS OPS OS OS OOS OS OPS OO OS OS OS OO OPS OS OS 


BAKHOST HOST INBFRS=15,MAXBFRU=15 , UNITSZ=196, BFRPAD=0, X 
SUBAREA=2, HOST SUBAREA = X'6000' X 
DELAY=0.1,STATMOD=YES , TIMEOUT=30 

CSB3 CSB TYPE=TYPE3,MOD=0 ,SPEED=(150,600,1200,2400) 

CSB2. CSB TYPE=TYPE2 ,MOD=1,SPEED=(134,600,1200) 

BAKLUP LUPOOL NUMBER=10 ACCESS M. COMPATIBILITY 

LUDRPOOL NUMTYP1=5 ,NUMTYP2=6 
veveteeve INSERT HERE X25STAGE1 OUTPUT 


XNET11 GROUP LNCTL=SDLC , LEVEL2=BALNAME2 , LEVEL3=BALNAML3 , USERID=(56689* 
81 ,BALMBDT) , LEVEL5=NCP , TIMER=(BALLAP4 , BALLAP4 , BALLAP4, BA* 
LLAP4) , XIO=(BALNAMXL, BALNAMKS , BALNAMXI , BALNAMXK) , DIAL=NO* 
» LSTATUS=INACTIVE 
~XLO24 LINE UACB= (X25A024X,X25A024R) , ADDRESS=(024 ,025), SPEED=9600 
SERVICE ORDER=XP024 
XP024 PU ADDR=01 , MAXDATA=261 , PUTYPE=1 
XU024 LU LOCADDR=0 
XLOA8 LINE UACB=(X25A0A8X, X25A0A8R) , ADDRESS=(0A8 ,0A9) , SPEED=9600 
SERVICE ORDER=XPOA8 
XPOA8 PU ADDR=01 , MAXDATA=261, PUTYPE= 1 
XU0A8 LU LOCADDR=0 
X25P024A GROUP LNCTL=SDLC, LEVEL2=BALNAVL?, LEVEL3=BALNAVL3 , LEVEL5=NCP , US* 
ERID=(5668981, BALPBDT) , TIMER=(BALNATER , BALNATRA, * 
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XL024000 


XP024000 
XU024000 
X25POA8A 


XLOA8000 


XP0A8000 
XU0A8000 
X25SO0A8B 


XL0A8007 
XP0A8007 
XLOA8006 
XPOA8006 


XLOA8005° 


XPOA8005 
XLOA8004 
XPOA8004 
XLOA8003 
XP0A8003 
XLOA8002 
XPOA8002 
XLOA8001 
XPOA8001 
X25S024B 


- XL024007 


XP024007 
XL024006 
XP024006 
XL024005 
XP024005 
XL024004 
XP024004 
XL024003 
XP024003 
XL024002 
XP024002 
XL024001 
XP024001 


BALNATST , BALNATLS ) , XIO=(BALNAVXL, BALNAVXS , BALNAVXI , BALNA* 
VXK) , DIAL=NO, ISTATUS=INACTIVE 

LINE ADDRESS=NONE , UACB=XA024000 

SERVICE ORDER=XP024000 


PU ADDR=01 , MAXDATA=261 , PACING=(1,1) , VPACING=(2,1) , PUTYPE=1 
LU LOCADDR=0 
GROUP LNCTL=SDLC , LEVEL2=BALNAVL2 , LEVEL3=BALNAVL3 , LEVEL5=NCP , US* 


ERID=(5668981, BALPBDT), TIMER=(BALNATER, BALNATRA, te 
BALNATST , BALNATLS) , XIO=(BALNAVXL, BALNAVXS , BALNAVXI , BALNA** 
VXK) , DIAL=NO , ISTATUS=INACTIVE 

LINE ADDRESS=NONE ,UACB=XA0A8000 

SERVICE ORDER=XP0A8000 


PU PUTYPE=1 , ADDR=01 , MAXDATA=261 , VPACING=(2,1) , PACING=(1,1) 

LU LOCADDR=0 

GROUP LNCTL=SDLC , LEVEL2=BALNAVL2 , LEVEL3=BALNAVL3 , LEVELS=NCP, US* 
ERID=(5668981,BALSBDT) , TIMER=(BALNATER, BALNATRA, we 
BALNATST , BALNATLS ) , XIO=(BALNAVXL, BALNAVXS , BALNAVXI , BALNA* 
VXK) , DIAL=YES , ISTATUS=INACTIVE 

LINE CALL=OUT ,ADDRESS=NONE , AUTO=YES , UACB=XA0A8007 

PU MAXLU=3 , PUTYPE=(1, 2) 

LINE CALL=OUT, ADDRESS=NONE , AUTO=YES , UACB=XA0A8006 

PU MAXLU=3 , PUTYPE=(1,2) 

LINE CALL=OUT, ADDRESS=NONE , AUTO=YES , UACB=XA0A8005 

PU MAXLU=3 , PUTYPE=(1,2) 

LINE CALL=INOUT, ADDRESS=NONE , AUTO=YES , UACB=XA0A8004 

PU MAXLU=3,PUTYPE=(1,2) 

LINE CALL=INOUT, ADDRESS=NONE , AUTO=YES , UACB=XA0A8003 

PU MAXLU=3 , PUTYPE=(1,2) 

LINE CALL=IN,ADDRESS=NONE , AUTO=YES, UACB=XA0A8002 

PU MAXLU=3 , PUTYPE=(1,2) 

LINE CALL=IN , ADDRESS=NONE , AUTO=YES , UACB=XA0A8001 

PU MAXLU=3 , PUTYPE=(1,2) 

GROUP LNCTL=SDLC, LEVEL2=BALNAVL2 , LEVEL3=BALNAVL3 , LEVEL5=NCP, US* 
ERID=(5668981,BALSBDT) , TIMER=(BALNATER, BALNATRA, * 
BALNATST , BALNATLS ) , XIO=(BALNAVXL, BALNAVXS , BALNAVXI , BALNA* 
VXK) , DIAL=YES , ISTATUS=INACTIVE 

LINE CALL=INOUT,ADDRESS=NONE , AUTO=YES , UACB=XA024007 

PU MAXLU=3 , PUTYPE=(1,2) 

LINE CALL=INOUT, ADDRESS=NONE , AUTO=YES , UACB=XA024006 

PU MAXLU=3 , PUTYPE=(1,2) 

LINE CALL=INOUT, ADDRESS=NONE , AUTO=YES, UACB=XA024005 

PU MAXLU=3 , PUTYPE=(1, 2) 

LINE CALL=INOUT , ADDRESS=NONE , AUTO=YES , UACB=XA024004 

PU MAXLU=3 , PUTYPE=(1,2) 

LINE CALL=INOUT,ADDRESS=NONE , AUTO=YES , UACB=XA024003 

PU MAXLU=3 , PUTYPE=(1,2) 

LINE CALL=INOUT, ADDRESS=NONE , AUTO=YES , UACB=XA024002 

PU MAXLU=3 , PUTYPE=(1,2) | 

LINE CALL=INOUT, ADDRESS=NONE , AUTO=YES , UACB=XA024001 

PU MAXLU=3 , PUTYPE=(1,2) 


week TNSERT HERE X.25 GENEND MACRO 


GENEND INIT=BALINIMD, INCINIT=DO1INI , INCL2HI=DO1HII , INCL2LO=D01* 
LOI , SRCHI=DO1BLK , SRCLO=D01TBL,ORDL2LO=D01L00 , ORDL2HI=D01* 
HIO, ORDINIT=DO1INO, TMHRTICK=BALTICK 


END 
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ACCESS METHOD CONSIDERATIONS 


ACF/VTAM CONSIDERATIONS 


VTAM macros are not changed to define a configuration using a PPSN. 
However, some rules have to be followed when coding the parameters 
required to define a major SNA switched node. 


VBUILD Macro Instruction 


There are no special considerations for this macro instruction. 


PU Macro Instruction 


¢ The "ADDR="" operand must be coded even though it has no meaning for 


the 


e For 


X25NPSI environment. Any value below 255 can be specified. 


LLC level 2, the "“MAXDATA=" operand must reflect the 


characteristics of the PU. 


For 


LLC level 0, the "MAXDATA="" operand must be coded with a value 


greater than or equal to at least the maximum size of the RUs sent 
by the application to the pseudo-LUs in the 3705. 


° For 
For 
e For 
For 


LLC level 2, the "IDBLK=" operand is coded in a standard manner. 
LLC level 0, this operand must be coded 003. 


LLC level 2, the "“IDNUM=" operand is coded in a standard manner. 


LLC level 0, you should remember that the “remote identification 
number’ generated in the CALL REQUEST packet, and therefore received 


- in an INCOMING CALL packet, is equal to: 
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Either the "IDNUM="" operand (SSCP identification number) plus 
one, if this SSCP identification number (4Z4ZZZZ field) is 
specified in the "DIALNO=" operand of the PATH macro 
instruction. 


Or to the "Default Identification Number", if the ZZ22Z field is 


not specified in the "DIALNO="" operand of the PATH macro 
instruction. The default identification numbers are generated 
for each SVC at initialization time. They are generated in the 
order in which the SVCs appear in the RVT -- that is, in the 
order in which the SVCs appear in the generation deck. The 
default identification number is a value beginning at 2 with an 
increment of 2. 


In the above generation sample, the following values are 
assigned for the default identification number: 


x'0002' 


For XLOA8007 : The default identification number = 
XLOA8006 : . i "= x'0004' 
XLOA8005 : "™ . ‘i '" = X'0006' 
XLOA8004 : o " " " = x'oo00s' 


XLOA8003 : : m . ore X'O0O0A' 


XLOA8002 : " : - "= x'000C' 
XLOA8001 : "™ ss a "= X'"OO0E' 
XLO24007 : " " . "= x'0010' 


The default identification number value is stored in the 
VCBXIDDF half word (displacement of 2). 


¢ The "PUTYPE="" operand is coded in a standard manner for LLC level 2. 
For LLC level 0, this operand must be coded 1. 

PATH Macro Instruction 

¢ The "DIALNO="" operand of the PATH macro must be coded as follows: 
DIALNO=NNN...N [*MMM...M] L XX YY *222Z2ZZ 


The maximum length of the "DIALNO="" parameter is 32 characters, 
including asterisks. 


[*MMM...M] is an optional field that is required only when the calling 
DTE's network address must be specified. 


1. NNN...N 


Is the called DTE's network address. The number of N characters is such 
that: 1 << number < 15. 


2. MMM...M 


Is the calling DTE's network address. If this field is specified, 
the number of M characters is such that: 1 S$ number § 15. 


3. L specifies (in one byte) the level of LLC that will be used 
by the current connection. The accepted values are 0 or 2. 


L=0 LLC level 0 (Connection with X.25 non-SNA equipment not 
supporting interrupt packets, or with the X.25 
ECHO service). 

L=2 LLC level 2 (Connection with a 5973-L02). 

4. XX 

Is the two-byte VCCPT index whose value ranges from 00 to 19. 

XX=00 means that the packet procedure will work using the values 

defined in the entry of the VCCPT specified in the "“VCCINDX=" 

operand of the X25VC macro instruction. 

XX=xx means that the packet procedure will work using the values 


defined in the "xx' entry of the VCCPT. This entry must have been 
defined during X25NPSI generation. 
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Se VY 
Is the two-byte OUFT index whose value ranges from 00 to 19. 


YY=00 means that the CALL REQUEST packet is built with the facility 
field and the user data specified in the 'OUFINDX=" operand of the 
X25VC macro instruction. 


YY=yy means that the CALL REQUEST packet is built with the facility 
field and the user data defined in the yy entry of the OUFT. This 
entry must have been defined during X25NPSI generation. 


6. Z2Z22Z is the five-byte ID number of the PU ("IDNUM=" keyword). 
Each Z has a value from 0 to 9 in decimal notation. This field 
(including the asterisk) is required and valid only when LLC level 
O is specified. 


Examples: 


Take a typical connection with LLC level 2 under TRANSPAC. Assuming 
that the called DTE's network address is 175000233 and the default VCCPT 
and OUFT entries are used, you should code: 


DIALNO= 175000233 2 00 00 


Assuming that the called DTE's network address is 175000235, the VCCPT 
and OUFT entries 1 are used, the LLC level is 0, and the ID number of 
the PU is 66666, you should code: 


DIALNO= 175000235 0 01 01 *66666 


Assuming that the calling DTE's network address is necessary and is 
equal to 4444, the called DTE's network address is 333, entry 19 of the 
VCCPT is used, the OUFT default entry is used, the LLC level is 0, and 
the ID number of the PU is 66666, you should code: 


DIALNO= 333 *4444 0 19 00 *66666 
And the format of the corresponding CALL REQUEST packet would be 


(assuming that, in the OUFT default entry, a 4800 bps throughput class 


in transmission and a 2400 bps throughput class in reception are 
defined): 
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<——___—_—_—_——_§— 1 byte ———______"_>> 


[ee ee tee a, Oe at te Ge eee Oe ge ee ew all 


{ | Gen. Format Identifier | | 

{ |Logic. Chann. Grp Numb. | 

{ | oO oOo oOo 1 | | 

‘Shiai laiacicaancaecaia le acetic naeoat canara aan 

CALL REQ { | | 
Packet { | Logical Channel Number | 
Header { | | 
{ | Packet Type Identifier | 

{ | | 

{ | 0 0 0 0 1 0 1 1 | 


| Calling DTE Addr Length| Called DTE Addr Length| 
| 0 1 0 0 ; 0 0 1 1 | 
| Called DTE Address | 
| 0 0 1 1 0 0 1 1 | 


| Calling|DTE Address 


Es cnneisedanetisiinnensrianci 
| | Facility Length | 


| | | 


| 0 | 0 0 0 0 1 Oo | 
J 
| Facility Code | 
| 0 0 0 0 0 0 1 Oo | 
| Facility Parameter | 
| 1 0 0 0 1 0 0 1 | 
| Call User Data Field | 
| 1 1 0 0 0 0 0 G. 4 


| Remote IDNUM= SSCP IDNUM + 1 
| or default IDNUM 
| 
| 
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¢ The "REDIAL="" operand of the PATH macro is no longer significant. 
Even if you specify REDIAL=n, no dialing retry will be performed by 
the X25NPSI before returning a dialing error to VTAM. 


LU Macro Instruction 


For LLC level 0, the "PACING=" operand must be coded PACING=(1,1). This 
is the default value. For LLC level 0, the "“LOCADDR=" operand must be 
coded 0. : 


ACF/TCAM CONSIDERATIONS 


TCAM macros used to define a message control program are not changed 
when specifying a configuration using a PPSN. However, some.rules have 
to be followed when coding these macros. 


INTRO Macro Instruction 


This macro should be used carefully as far as TCAM buffers are 
concerned. A long inbound RU message may be split into many PIU 
segments to be adapted to the characteristics of the network. TCAM 
accumulates the PIU segments before delivering the complete RU to the 
application. This means that many TCAM buffers may be utilized at 
certain times to accommodate inbound messages. | 7 


TERMINAL (TERM=LINE) Macro Instruction 

¢ The "CALL="" operand specifies whether stations, the host, or both 
can initialize calls via the virtual circuits represented by the 
TERMINAL (TERM=LINE) macro instruction. This operand allows 
reserving a switched virtual circuit for a one-way call. 
In order to perform a call, the X.25 network chooses the first 
virtual circuit available with the lowest logical channel number. 
Therefore, in order to minimize the possibilities of call 
collisions, the TERMINAL: (TERM=LINE) macro instructions associated 
with the highest virtual line addresses should be used for eyteorne 
calls (CALL=OUT or INOUT). 

TERMINAL (TERM=PUNT) Macro Instruction 

° The "DIALNO="' operand should be coded as follows: 
DIALNO= X'FnFnFn...Fn [FC FmFmFm...Fm] Fl FxFx FyFy [FC FzFzFzF2Fz]' 
The differences between VTAM and TCAM are: 


— The maximum length of the "DIALNO=" errr in TCAM is twenty 
dial digits for 'F.' configurations only. 


DIALNO=DIRECT is not valid. 


5-46 


ee 


— In TCAM, the equivalent of * is the ‘FC' configuration. This is 
why hexadecimal notation is used when a delimiter configuration 
is needed. When you do not need to specify the MMM.M and 222ZZ 
fields, you may use the decimal dial digit notation. 


= In TCAM, the 2ZZ2ZZ field is optional. TCAM.can be generated so 
- as not to be concerned with the XID specified in the REQUEST 
CONTACT command resulting from an outgoing call. This is why 
the ZZ2ZZZ field is between parentheses. 


Otherwise, for a detailed description, refer to the previous 
discussion of the VTAM PATH Macro Instruction in the preceding 
"ACF/VTAM Considerations" section of this manual. 


As far as the ZZ2ZZZ field is concerned, you must remember that 
an SNA station identification is made up of four bytes: 


X'BBBZZZZZ' 


where X'BBB' represents the identification block, and X'Z2ZZz' 
represents the identification number. 


¢ The "DISCNT="' operand should be coded YES for the switched virtual 
PUs. It specifies that TCAM is to end the SSCP-PU session when all 
the PLU-SLU sessions are terminated. "YES" means TCAM will wait for 
a "REQUEST DISCONTACT" from the PU. | 


* The "“MAXDATA="" operand specifies the maximum length (in bytes) of a 
data segment for an SNA-switched PU. 


- For LLC level 2, this operand must reflect the PU's 
characteristics. 


. For LLC level 0, this operand must be coded with a value equal 
to at least the maximum size of the RUs sent by the application 
to the pseudo-LUs in the 3705. 
INVLIST Macro Instruction 


The ‘‘ORDER="" operand specifies the invitation list entries for the line. 


If TCAM has to perform an ID verification for NCP-attached stations, you 
have to remember that: 


° For LLC level 2, the identification block is coded in a standard 
manner. For LLC level 0, this operand must be coded 003. 


e For LLC level 2, the identification number is coded in a standard 
manner. For LLC level 0, you should remember that the remote 
identification number is generated in the CALL REQUEST packet and 
therefore received in an INCOMING CALL packet. It is equal to: 


- z222zz plus one, if this field is specified in the 'DIALNO=" 
operand 
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The default identification number, if the 


not specified in the "DIALNO=" operand. 
of the VTAM PU macro instruction for more 
default identification number. 


'FoPzFererz’ field is 
Refer to the discussion 
details concerning the 


NETWORK OPERATOR CONSIDERATIONS 


ACTIVATION/DEACTIVATION 


All the SNA resources should be activated, except for the LU of the MCH 
(which is not used). 


Activation of the SNA resources may be performed in any order. X25NPSI 
will synchronize the SNA activation commands with network action and 
handle both in the appropriate sequence. For example, the CONTACT/XID 
of the VCs will be accepted only when the connection is established with 
the network. 


Note that deactivating the MCH's PU will involve the deactivation of all 
the virtual circuits defined on this MCH. 


The remainder of this section describes the actions performed by X25NPSI 
for operator commands. 
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TNL SN30-3213 (26 Feb 82) to SC30-3078-0 
MULTICHANNEL (MCH) COMMANDS 


OPERATOR SSCP 3705 X.25 Node 


VTAM: V NET,ACT, ID=linename 
TCAM: F Procname ,ACTIV=linename 
Act Link MCH 


> Set DTR 
> 
DSR on 
Positive Response < 
FA RO NRO ae ER TO 
VTAM: V NET,ACT, I1D=puname 
TCAM: F Procname ,ACTIV=puname 
CONTACT 
ie 
Frame With Address=0 
(For CSB3 Only) (Note 1) 
> 
SABM (P) (Note 2) 
> 
UA (F) 
< 
RR (P) (Note 3) 
: : > 
CONTACTED RR (F) 
an 


Restart Packet (Note 4) 
eee ae 


Restart Confirm. 
Activate PU MCH 


Positive Response 
< 


VTAM: V NET, INACT, 1D=puname 
TCAM: F Procname , DEACT=puname 
Deactivate PU MCH 


Positive Response 
< 


DISCONTACT 
DISC—Frame 
Gh reané 

Positive Response 


< 


Inop Station for all active VCs 
Fe ee ee eee ee ce 
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VTAM: V NET, INACT, ID=linename 
TCAM: F Procname , DEACT=linename 
Deact Link MCH 
> Reset DTR 
> 
DSR off 
Positive Response < 
en 


NOTE 1: In case of the scanner CSB3 only, the X.25 NPSI sends this 
invalid frame (Address=X'00') for initialization of the 
scanner itself. The DCE should not be disturbed by this 
frame because the CCITT recommendation specifies that a 
frame with an invalid address must be discarded. 

NOTE 2: In case of no answer to this SABM after the retries, the 
X.25 NPSI does not send a DISC command because the link 
set-up has not been completed. 

NOTE 3: In case of no answer to this RR command after the retries, 
the X.25 NPSI does not send a DISC command because the 
link set-up is not considered complete. 

NOTE 4: It is only after the exchange of the RR Command/Response 
that the X.25 NPSI sends the restart request packet. 
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TNL SN30-3213 (26 Feb 82) to SC30-3078-0 


OP 232 
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MCH Recovery 
For Inoperative Station, the PU must be reactivated. 
For Inoperative Link, the link and the PU must be reactivated. 


If you issue a deactivation command for the MCH's PU, all the VCs 
defined on this MCH will be deactivated immediately. 


A smooth deactivation consists of the following: 

° Deactivation of the LUs, PUs, and links of the PVCs. 
° Deactivation of the LUs, PUs, and links of the SVCs. 
: Deactivation of the MCH's PU and link. 


NOTE: The X.25 NPSI Program Product sends a DISC 
command after receiving an FRMR frame. 
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THE PERMANENT VIRTUAL CIRCUIT (PVC) — LLC LEVEL 2 (LLC=PSH) 


OPERATOR SSCP 7 3705 


VTAM: 
TCAM: 


VTAM: 
TCAM: 


VTAM: 
TCAM: 


VTAM: 
TCAM: 


VTAM: 
TCAM: 


V NET,ACT,ID=linename 
F Procname ,ACTIV=linename 
Act Link PVC 


Positive Response 
< 
V NET,ACT, ID=puname 
F Procname , ACTIV=puname 
CONTACT 
> 


Positive Response PSCONT 


X.25 Node 


a SS SS ee ee ee 


PSCONT 
< 


CONTACTED 
< 


Activate PU Type 1 PVC 
— 


Positive Response 
< 


or Activate PU Type 2 


Positive Response 
< 


V NET, ACT, ID=luname 
F Procname ,ACTIV=luname 
Activate LU 


Positive Response 
< 


V NET, INACT, I1D=puname 
F Procname , DEACT=puname 
Deactivate PU PVC 


Positive Response 
ee 

PSDISC 

PSDISC 


Positive Response 
< 5 : 


V NET, INACT, ID=linename 
F Procname , DEACT=linename 
Deact Link PVC 


Positive Response 
< ; 
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COMPATIBILITY/INCOMPATIBILITY CONSIDERATIONS 


X25NPSI provides the X.25 interface control for ACF/NCP Version 1 
Release 2.1 and up, without adding any incompatibility with the NCP 
support for the resources not connected through X25NPSI. However, some 
limitations are listed below. They are related to the ACF functions 
available for the X25NPSI-controlled resources, and to the use of host 
network control facilities. 


SUPPORTED AND NON-SUPPORTED ACF FUNCTIONS 


The following table shows whether the ACF functions are supported 


according to the X25NPSI links: MCH, PVC, or SVC. 


[eg ee re gs ee eee Soe Se re es ey 
| X25NPSI LINKS | 


ae ets ica iat ech deieaee dae oa tareninatel anand 
| ACF Functions | MCH | PVC | SVC | 


| | | | | 


| Link level 2 Test | NO | 
| | Negative Resp. | 
| | Sense X'081C' | 
ee SAAS es: eNe eeee e 


| Line trace | YES | Not applicable because | 
| | as for SDLC line| no physical connection | 


| OLLT | T3700LTA/B only | | 
| | See section | Not applicable because | 
| | "Tools to check | no physical connection | 
| | the Hardware" | | 
| Backup SSCP for | Allowed | Allowed | Not allowed | 


| Netw. Resources | | | | 


fe | 


| Dynamic Reconfig. | NO | Allowed only for LUs. Not for PUs | 
a a 
| Negotiable bind | Not applicable | For SNA resources only, | 


| | | that is, for LLC2 only | 


ef | 


| Intensive Mode | NO, negative response | 
| Recording | Sense X'1003' | 
Fa esha ni real alana nmcetie 
| Link Problem | NO | 


| Determination Aid | | 
Cee aie nS eee eee NE TENT: (a ec Pe ae PSAP Ee aT OO Nee OPM eRe CE TP RT ee ae Eee ae ee OEE Ee 
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HOST NETWORK CONTROL AIDS CONSIDERATIONS 


NPA cannot be used to collect data from the pseudo-SDLC links 
representing the physical connection to the X.25 network (MCH) and the 
virtual circuits. For these pseudo-links, the related LINE macro should 
be coded with NPA=NO (ACF/NCP Version 1 Release 4). 


ACF/TAP cannot be used to format the trace records generated by the 
X25NPSI for the X.25 multichannel links. 


NPDA cannot be used to format the RECMSs generated by the X25NPSI for 
the resources connected to the 3705 through the X.25 network. However, 
the user can develop his own formatting routine for X.25 RECMSs on the 
CNM EXIT provided by NCCF. If requested by the NPDA operator, NPDA 
displays the X.25 RECMSs in hexadecimal notation. 


PVC Recovery 


For Inoperative Station, the PU and the LU must be reactivated. 


For Inoperative Link, the link, the PU, and the LU must be reactivated. 


THE SWITCHED VIRTUAL CIRCUIT (SVC) — LLC LEVEL 2 (LLC=PSH) 


Outgoing Call (for TCAM) 


OPERATOR SSCP 3705 X.25 Node 


TCAM: F Procname , ACTIV=linename 
Act Link SVC 


> 
Positive Response 
aoe 
TCAM: F Procname , ACTIV=puname 
CONNECT—OUT 
> 
Positive Response Call Request 
a Dn 
Call Connected 
< 
PSXID 
> 
PSXID (Station) 
< 
Request Contact 
Fa I ee eT PEON EN 
set Control Vector—PU 
a ane ee ee EE 
Positive Response 
< 
CONTACT 
> 


..then same as for PVC or standard SNA switched PU/LU.... 
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Incoming Call (for VTAM) 


OPERATOR SSCP 3705 X.25 Node 


VTAM: V NET,ACT, I1D=luname , ANS=ON 
| Act Link SVC 


| Positive Response ° 
‘ leuieaie Connect—In 
Positive Response ° 
: Incoming Call 
. Call Accepted 
PSXID ° 
> 
PSXID (Station) 
Reaneee Contact ° 
pp Control Vector—PU 
Positive Response ° 
CONTACT 
. > 


...lhen same as for PVC or standard SNA switched PU/LU.... 


SPECIAL DATAPAC CONSIDERATIONS 


With DATAPAC, when the NCP stops before a DISC command is sent to the 
network, the next MCH activation will fail because the network does not 
detect the lack of inter-frame flags and does not send a SABM to the 
3705. When the timeout elapses, the 3705 sends a DISC so that the next 
activation will be performed successfully. | 
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SLOWDOWN AND AUTO NETWORK SHUTDOWN 


X25NPSI_ SLOWDOWN PROCEDURE 


The NCP slowdown procedure is a means of partially restricting the NCP's 
activity if the number of available buffers reaches a predefined lower 
system threshold (LST). The NCP exits from SLOWDOWN when a predefined 
upper system threshold (UST) is reached. The UST is 150% of the LST. 


_X25NPSI also has its own slowdown procedure: 


° Two thresholds are defined (see the description of the X25VCCPT 
macro in the "X25NPSI Installation" section of this manual): 


- The SAFE/UNSAFE threshold is, by default, equal to 125% of the 
LST. : 


- The UNSAFE/DANGER threshold is, by default, equal to the LST. 


e After the NCP's initialization, all the VCs are in the SAFE 
Situation. 


ENTERING SLOWDOWN 


When the number of available buffers reaches the SAFE/UNSAFE threshold 
for a VC (equal to 125% LST by default), the activity on this VC enters 
the UNSAFE state and the virtual circuit window size is restricted to a 
value of one as long as the DCE timer does not elapse. Each time the 
DCE timer elapses, the window size is increased by one. 


When the number of available buffers reaches the UNSAFE/DANGER threshold 


for a VC (equal to the LST by default), the X25NPSI enters the DANGER 
state for this VC. 


° RNR packet is sent when the window is closed, and when the More Data 
Bit is OFF. | 


e The window is decreased to 1 as long as the packets received carry 
the MDB, but, each time the DCE timer elapses, an RR is sent. 


If the number of available buffers is equal to eight, no more buffers 
can be leased and the LAC sends an RNR frame over all the multichannel 
links. | 

EXITING FROM SLOWDOWN 

As soon as the number of available buffers exceeds sixteen, the LAC 


resumes line activity by sending an RR frame over all the multichannel 
links. | | | | 
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In the DANGER situation, exiting is always performed from DANGER to 
SAFE: 


e At the highest of UST or SAFE/UNSAFE thresholds when in QUIESCE 
mode. 


e At the SAFE/UNSAFE threshold when in DANGER but not in system 
QUIESCE mode. 


The X25NPSI exits from the UNSAFE state and enters the SAFE state when 
the SAFE/UNSAFE threshold is reached. All the virtual circuit windows 
are set to their normal size (set at generation time for PVCs, or 
established at CALL time for SVCs). 


The host is not aware that the X25NPSI has entered the slowdown 
- procedure except when the NCP is also in QUIESCE mode, in which case Ali 
the virtual circuits are, all the more, in DANGER state. 


Figure 7-1 shows how the X25NPSI slowdown procedure works. 
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-.Number of | | A 
available | - | Windows Windows | 
buffers | | opened opened | 

| | | 
— | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | Safe | 
| | A | 
| | | | 
| | | | 
US) SS =] SSS eS eS  antleetaenteedaaelceedceedlen teeta online —— 1 a a Re 
Al[ | | 
| . | | safe | Safe | 
25% LST | | | | A | 
lt | | | | 
| Vo.» «| V | | 
SS Se Se es Se ey ee See eae pre | me rar ee 
A | | | | 
ft ve | | 
25% LST | | Unsafe (Window=1) Unsafe | 
| | | 
| Vi | | 
ee ft are ee ee 
U/D | — | | | 
| V (Window=1 if MDB: RR packet) © | 
| Danger | Danger 
| (Window=0 if not MDB or SI: RNR packet) 
| | 
| 
| RR Frame 
| A 
| | 
7 ae | 
16 | ------------ ee er ere ee —+—-------- 
| | 
| RR Frame | 
| | | 
| | | 
Sl SaaS SS eer eae ae Se See es a eae Save 
| | | 
| Vv | 
| RNR Frame © RNR Frame 
| 


Figure 7-1, X25NPSI Slowdown Procedure 
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THE AUTO NETWORK SHUTDOWN (ANS) PROCEDURE 


The NCP enters ANS when no more paths are available between the host and 
the 3705. 


The NCP performs the Auto Network Shutdown (ANS) for SNA links owned by 
the SSCP undergoing ANS by: 


e Clearing the SSCP undergoing ANS as link owner 
° Exiting from the ANSWER mode on switched links 


e Taking any link with LINE TRACE ACTIVE, activated by the SSCP 
undergoing ANS, out of LINE TRACE mode 


° Quiescing links in OLLT mode 

e Quiescing links with link Test, level 2 active 
. Resetting intensive mode recording 

e Breaking switched connections 


The NCP performs ANS for SNA devices for which ANS=STOP is specified, 


e Sending a DISC command and stopping polling operations 
: Breaking the switched connections 

° Clearing the SSCP undergoing ANS as the station owner 
° Resetting all session states 

Then, the X25NPS™ reacts to the NCP's actions by: 


° Sending a DISC frame over the MCHs which are found active if 
ANS=STOP is coded in the corresponding PU 


e Sending a DISC-LLU over all the permanent virtual circuits that have 
been found active if ANS=STOP is coded in the PU macro 


. Sending a DISC-LLU over all the switched virtual circuits which have 
been found active, and then breaking the connection by sending a 


CLEAR REQUEST packet 


e Exiting from the ANSWER mode on all the other switched virtual 
circuits 
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COMPATIBILITY/ INCOMPATIBILITY CONSIDERATIONS 


X25NPSI provides the X.25 interface control for ACF/NCP Version 1 
Release 2.1 and up, without adding any incompatibility with the NCP 
support for the resources not connected through X25NPSI. However, some 
limitations are listed below. They are related to the ACF functions 
available for the X25NPSI-controlled resources, and to the use of host 
network control facilities. 


SUPPORTED AND NON-SUPPORTED ACF FUNCTIONS 


The following table shows whether the ACF functions are supported 
according to the X25NPSI links: MCH, PVC, or SVC. 


Ht Ra Pe ONG Re ree ee yee OE Nery ee Ee ne ee ee ey ee Sree 


| X25NPSI LINKS 


eS ee 


| ACF Functions | MCH | PVC | SVC 


| | | | 


(Sa ca | Ss ca 


| Link level 2 Test | NO | YES 
| | Negative Resp. | 
| | Sense X'081C' | 


pp fe 


| Line trace | YES | Not applicable because 
Ls | as for SDLC line| no physical connection 


| | T3700LTA/B only | 
| | See section | Not applicable because 
| | “Tools to check | no physical connection 
| | the Hardware" | 
| Backup SSCP for | Allowed | Allowed | Not allowed 
| Netw. Resources | | | 
| Dynamic Reconfig. | NO | Allowed only for LUs. Not for PUs | 
| Negotiable bind | Not applicable | For SNA resources only, 


| that is, for LLC2 only 


| Intensive Mode | NO, negative response 
| Recording | Sense X'1003' 


i a a 


HOST NETWORK CONTROL AIDS CONSIDERATIONS 


NPA cannot be used to collect data from the pseudo-SDLC links 
representing the physical connection to the X.25 network (MCH) and the 
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virtual circuits. For these pseudo-links, the related LINE macro should 
be coded with NPA=NO (ACF/NCP Version 1 Release 4). 


ACF/TAP cannot be used to format the trace records generated by the 
X25NPSI for the X.25 multichannel links. 


NPDA cannot be used to format the RECMSs generated by the X25NPSI for 
the resources connected to the 3705 through the X.25 network. However, 
the user can develop his own formatting routine for X.25 RECMSs on the 
CNM EXIT provided by NCCF. If requested by the NPDA operator, NPDA 
displays the X.25 RECMSs in hexadecimal notation. 
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PROBLEM DETERMINATION AIDS 


Different tools are at your disposal for problem determination. 
Although the use of these different tools is often simultaneous, they 
can be divided into four classes: 


por 


1 


2 


a. 


Tools to check the hardware 
Trace 
Reports 


Dump/Snap 


TOOLS TO CHECK THE HARDWARE 


Figure 9-1 shows a typical hardware configuration. 


The numbers identify the various tests. 


The letters identify the possible traces. 
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TERMINAL/ 
CLUSTER 


Hardware Configuration 


Figure 9-1. 
Ie 2 


The tests corresponding to arrows 1 to 6 can be performed in the 
following manner: 


OLLT 


If the OLT=YES operand is specified in the BUILD macro instruction of an 
NCP generation, the Online Line Tests (OLLT) can be performed on the 
multichannel links. Processing the OLLT on a PVC or SVC would, of 
course,.lead to a "resource not available" report, because a PVC or SVC 
does not correspond to a real physical connection. The OLLT consists in 
sending PIUs consisting of interpretative chain commands to the OLLT NCP 
processor by means of VTAM's TOLTEP program. 


: Arrow 1: 
The test corresponding to arrow 1 may be performed by means of the 
T3700LTA test. It consists in a wraparound at line set level, 
excluding the interface drivers. 
e Arrow 2: 
The test corresponding to arrow 2 may be performed by means of the 
T3700LTB test, provided the modem has a wrap switch at the entry. 
NIA WRAP 


e Arrow 3: 


The 5973-L02 NIA may perform the test corresponding to arrow 3, 
provided the modem has a wrap switch at the entry. 


Please refer to the 5973-L02 Product Description Manual, GA11-8643, 
for more details and operation guidelines. 


: Arrow 4: 
The 5973-L02 NIA is equipped with a wrap switch at SDLC procedure 
level, and thus can be seen as a modem by an SNA terminal. 

USING ECHO WITH AN APPLICATION 

° Arrow 5: 
This test corresponds to a communication with the "Echo service" of 
the PPSN. Please refer to the "Communicating with the Network 
Services’ section of the chapter titled "Communications with non-SNA 
X.25 DTEs". This test invokes software as well as hardware. It 


needs an application program and can be seen as a tool to debug an 
application program. 
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LINK LEVEL 2 TEST FOR A VC 
e Arrow 6: 


This test invokes an end-to-end communication. This test can be 
performed by: 


1. Using the IBM SSCP test from the SNA terminal. 
2. Using link level 2 test from the host: 


a. For a PVC, only the link should be activated before issuing the 
command that performs the test. 


b. For an SVC, the connection should be established. This means 
that XIDs should have been exchanged. 


This test can be performed with IBM terminals connected to the X.25 
network via the NIA, supported with LLC level 2 (PSH). It may also be 
performed with non-SNA X.25 DTEs (LLC level 0) if they support the ECHO. 
packet. 


In any case, the data length must not exceed the packet length minus 
two. If this length is exceeded, the link level 2 test request is 
rejected by the X25NPSI. 

This test is performed without using a host application program. Thus, 
the operation guidelines for permanent virtual circuits differ from 


those for switched virtual circuits. 


1) Permanent virtual circuit 


OPERATOR SSCP 3705 Node 5973-L02 Terminal 


Line Set up Line Set up (E) 
<> <—_____—_—_> 


VTAM: F NET,LL2,1D=puname,NTRANS=1 
TCAM: F procname,ACTIV=puname,...... 


EXECTEST 
anne, 
PSH-TEST - S$DLC-TEST 
> —_—_————_____—_ > 
PSH-TEST SDLC—TEST 
Gee eee (Ey x 
Report | 
< 


Once the X.25 line setup has been performed, first between 
the 3705 and the PPSN node, and second between the NIA and 
the PPSN node, the operator may key a command to activate 
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2) 


the link level 2 test. The EXECTEST command sent by the 
SSCP results in a PSH-TEST LLU being transmitted to the 
5973-L02. Then, the PSH-TEST LLU is changed into an 
SDLC-TEST over the SDLC line and, when the answer is 
received, the 5973-L02 sends the PSH-TEST back to the 3705. 
The X25NPSI makes a report to the SSCP to tell it whether 
the test was successful. The 5973-L02 remains in the E 
state. 


In this manner, it becomes possible to follow the 
transmission of a message along the entire path. 


Switched Virtual Circuit Under VTAM: 

In this case, the problem is somewhat different. Because 
an operator cannot send a CONNECT OUT command directly 
without an application program, it is better to initiate 

the call from the 5973-L02 NIA. 

SSCP 3705 Node 5973-L02 Terminal 


Line Set up Line Set up 


<>  <—_______> 
(B) 
ACTIVATE 
CONNECT-—IN 
> 
+ RSP 
Pe a ane 
Call Request 
oa Se 
Incoming Call 
FE OTR I OT 
Call accepted 
———________> 
Call connected 
> (EB) 
XID LLU 
> 
XID Station. LLU 
< 
REQ. CONTACT 
oe 


Once the line setup and the ANSWER command have been 
performed, a 5973-L02 operator may key dial digits to call 
the 3705 over the wanted line. 


The 5973-L02 state goes from B to E when the CALL CONNECTED 
packet is received. 


X25NPSI Program Description and Operation Manual 9-5 


3) Switched Virtual Circuit Under TCAM: 


Operator SSCP 3705 Node 5973-L02 Terminal 
Line Setup Line Setup 
<> <-> 
(B) 


F procname ,ACTIV=puname 
Connect—out 
> 
+RSP 
<_——_————-_ Call Req __ Incoming Call 
as 
Call Conn. Call Accepted 
<—_____—  <—_____ (E 
XID (LLU) 


Station XID—-LLU 
< 


Req contact 
Fe OTE OT PTC 


Once the X.25 line setup has been performed, first between 
the 3705 and the PPSN node, and second between the NIA and 
the PPSN node (Status B of the NIA), the operator may enter 
a command to acquire a terminal (F procname, 
ACTIVE=puname). When the call is accepted, the state of 
the NIA changes to E. 


GENERALIZED TRACE FACILITY (GTF) 


The Generalized Trace Facility (GTF) is a service aid program available 
under OS/VS to trace selected system events. The trace output, when 
formatted and printed by the EDIT function of PRDMP, is useful in 
determining and diagnosing problems that may arise while using OS/VS1. 
As far as the X25NPSI is concerned, you may use this facility: 


1. To trace the exchange of PIUs with a particular destination between 
the host and the 3705: (a) in Figure 9-1. 


2. To trace the line activity between the 3705 and the network node: 
(b) in Figure 9-1. 


To obtain more detailed information concerning the use and operation 


guidelines for the GTF and PRDMP facilities, use the appropriate 
operating-system and access-method documentation. 


In order to use GIF, you should perform the following operations: 
1. First, start the GTF program: 
//S81 EXEC PGM=HHLGTF, 
PARM= 'MODE=EXT , DEBUG=NO , TIME=YES ' 
//SYSPRINT DD SYSOUT=A ,DCB=BLKSIZE=1089 , 
//TEFRDER DD DSN=SYS1.TRACE,UNIT=3400-4,DISP=OLD, 
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VOL=SER=NLTAPE 
— {/SYSLIB DD DSN=SYS1.PARMLIB(VTGTFTRA) , DISP=SHR 
/* 


where the VIGTFTRA member in the SYS1.PARMLIB is defined by: 
TRACE=RNIO,USR 
2. Then, specify to VTAM what you want to trace: 


MODIFY PROCNAME, TRACE ,TYPE=BUF ,ID=resource name(LINK, PU, LU) 
MODIFY PROCNAME, TRACE ,TYPE=LINE,ID=line name 


3. At the end, stop GIF and process the following job to get output 
editing: 


//PRINT EXEC PGM=HMDPRDMP 
//SYSPRINT DD SYSOUT=A 
//PRINTER DD SYSOUT=A , DCB=BLKSIZE=1089 


//TAPE DD DSN=SYS1.TRACE ,UNIT=3400-4, 
// DISP=OLD , VOL=SER=NLTAPE 
//SYSIN DD DSN=SYS1.PARMLIB(GTFTPIOA) ,DISP=SHR 


where the GIFTPIOA member in SYS1.PARMLIB is defined by: 


EDIT DD=TAPE,USR=(TPIO). 


LINE TRACE FACILITY 

The standard ACTIVATE and DEACTIVATE LINE TRACE commands are available 
for a multichannel link working with a Communications Scanner type 2 or 
3. They allow tracing all the bytes on the line. 

Because no physical connection is associated to a PVC or SVC, the 
ACTIVATE and DEACTIVATE LINE TRACE commands are not used and are 
rejected by X25NPSI with a negative response. 

ERROR REPORTS 

When an invalid request is encountered, or when an abnormal condition 
occurs without provoking a hard stop, the NCP reports this event to the 
access method by means of the following messages: 

od Exception Response 

. Inoperative 


e Record Maintenance Statistics 


When an invalid SSCP request is detected by an NCP initializer, the NCP 
generates an SNA exception response. 


X25NPSI Program Description and Operation Manual 9-7 


If the SSCP request is valid, but if an NCP terminator detects an 
abnormal condition, the NCP generates an SNA exception response followed 
by an RECMS. The purpose of this RECMS is to explain the circumstances 
of this abnormal condition. 


When the NCP detects an abnormal condition not caused by a request 
message, the NCP generates an inoperative message followed by an RECMS: 


e If this is an RECMS for SNA Station Error, the SSCP may again try to 
contact the physical unit and, for VTAM, will schedule the LOSTERM 
exit routine of the application program after "n" unsuccessful 


retries. 


° If this is an RECMS for SNA Link Error, the SSCP considers it as a 
hardware error and sends an ABANDON CONNECTION command. 


: The RECMS for SNA statistics are generally used for statistics. 
They are sent when a counter becomes exhausted, or after an 
INOPERATIVE link, for all the dependent stations. 


The Exception Response and Inoperative messages are a means of keeping 
the host console operator informed of what goes on. The Record 
Maintenance Statistics messages, which contain more detailed 
information, are recorded on: 


° SYSERR under a VM System 
e $YS1.LOGREC, and possibly the NCCF file under an OS/VS System 


: SYSREC under a DOS/VS System. 


EXCEPTION RESPONSES 


Exception Responses are identified in the RH by RH1BO bit 5 being ON. 

In this case, the RU is displaced four bytes to the left to make room 

for sense data. The first two bytes (bytes 0 and 1) of this sense data 
contain the exception response code. 


Bytes 2 and 3 contain user-specified sense information. The exception 
response code information (used by this X25NPSI) is set by the PCNE or 
the NAS and is as follows: 


EXCEPTION RESPONSE CODE MEANING 
X'0001' Component not available 
X'080C' Activate line trace on rejected VC 
X'0813' Bracket rejected, or BB request received 


from the host on an OIC or LIC request 
with exception response , 


X'081B' | Receiver. in transmit 

X'081C' Link test level 2 rejected on an MCH 
X'081C' | ACTLU rejected on an MCH 

X'0821' Invalid session operand 

X'0850' Load/dump failed 


X'08F3' Invalid SC/DFC requests 


X'O8F4' PCNE error 

X'O8F5 ' Segmenting not supported 

X'O8F6' Interrupt confirmation not received 
X'O8F7' Interrupt request contention 

X'O8F8' DFC request not supported 

X'O8F9' SHUTD request not currently allowed 
X'1003' Function not supported 

X'2002' Chaining error 

X'2003' FMD without Begin Bracket or Exception 


Response requested on OIC during 
conditional bracket initialization 
X'400C' Bracket not supported 
X' 8007 ' Segment error 


INOPERATIVE MESSAGES 


Inoperative messages are "Function Management Data" messages. More 
precisely, they belong to the "Physical Configuration Services". The 
format of an INOPERATIVE message is the following: 


TH1 | RH1 | RU 
| | 

Sees , prneer Lees poraes ‘aoa aaeeaa unas eres Tabs peeres 1 
| | | | | | | | [Network | | 
| / of | | | |X'O1'|X'02"|x'81'| | | 
| / {| | | | | | | Address | | 
Uses eee / / eas athe “= Ste ated Lace ee iaevesteraives peer Lge ie eleeaes Vitel eae ae cas ses Nees _ 

Byte 0 | X'01' Resource failed | 

Bits 1, 2 <--- X'02' Link failed <--- 

B'00' 


| ORR LN Sener e TEEPE ARE AE Te ATA RENE 


X25NPSI generates INOP LINK or STATION messages. Before sending An INOP 
STATION message, LAPB sends a DISC command to the network. At this 
point, X25NPSI is waiting for an ACTIVATE PU. Before sending an INOP 
LINK message, X25NPSI disables the modem and waits for an ACTIVATE LINK 
followed by an ACTIVATE PU. 

INOPs for a VC 

There are four categories of failure for a VC: 


1. Failure at MCH level 


2. Failure at VCM level 
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3. Failure at PLP level | 
4. Failure at LLC level 


The following table indicates the actions to be taken in case of various 
types of failure in each of these categories. 


| Failure | Category | Event | Action | 

| Level | of failure| | | | 

SSS SSS 

| | | | 

| MCH | | MCH down | INOP station | 
INOP station 


| | | 
VCM | ‘Timeout | Timeout on CALL REQUEST | 
| | (Connect -out) | | 
| | | 


Timeout on CLEAR REQUEST INOP station 


Out going LLC type invalid INOP station 
call LLC type not supported INOP station 
refused Invalid VCCPT index INOP station 


| | | | 
| | | | 
| | | | 
| | | | 
| by the | Invalid OUFT index | INOP station | 
| X25NPSI_ | | INOP station | 
| | | | 
| | | | 
| | | | 
| | | | 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| Slowdown during Connect-out 

| Command refused due to INOP: station 

| MCH failure 

| Command refused because VC not 

: defined for CALLOUT INOP station 

| | | | | 
| | Incoming | LLC type invalid. | RECMS link | 
| | call | LLC type not supported | RECMS link | 
| | refused | VC not in answer mode | RECMS link 
| | | | VC defined with CALL=OUT only | RECMS link | 
| | | Contention | RECMS link | 
| SSS SS 
| | | | | 
| | Clear | | | 
| | Indication| | INOP station | 
| | received | | | 
| SSS SS SS ee 
| | | | | 
| | Reset | | | 
| | Indication| | INOP station | 
| | received | | | 
| SS SSS SSS Se SS 
| | | | | 
| | Restart | VC inactive | No action | 
| | Indication| | | 
| | received | VC active | INOP station | 
| 

| | | | | 
| | Invalid or| | | 
| | not | | | 
| | supported | Before XID exchange | No action | 
| | control § | | | 
| | packet | After XID exchange | INOP station | 
| | received | | | 


Ca a Na ee a aN a ee) 
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Event 


| Failure 


| Level 
| PLP 


LLC 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


| Category 


| of failure| 


| LLC-OUT 


| 
| 


| Dispatcher | 


Invalid P(S) received 


LLU to be sent on X.25 LVL3 
Status different from 
Information Transfer (P4) 


Invalid PU type in XID 
XID-LLU to be sent on: 


*aq PVC 


*or state different from 


XMIT-XID 


Timeout and retries exhausted 
Invalid/Unexpected NS-LLU recvd 
CMDR received ; 


Invalid N(S) rcevd in an I-LLU 


I-LLU to 


different from "PSH Data Transfer" 


be sent on state 


I-LLU received on state 


different from "PSH Data Transfer" 


Contact/Discontact request out of 


valid PSH state 


Discontact processing on a PVC 
due to an ANS condition 


Error in 
LUSREQ: 


Error in 
LUSREQ: 


Error in 
LUSREQ: 
state 


Error in 
LUSREQ: 


Error in 
LUSREQ: 


Error in 
LUSREQ: 


Error in 
LUSREQ: 


inbound detected by 
No SSCP-SLU session 


inbound detected by 
No PLU-SLU session 


inbound detected by 
SLU in RCV or FME-WAIT 
inbound detected by 


SHUTC state entered 


inbound detected by 
Wait for DFC response 


inbound detected by 
No DFC request pending 


inbound detected by 
Begin bracket pending 


| Action | 


|INOP station | 


|INOP station | 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


INOP 
INOP 


INOP 
INOP 
INOP 


INOP 


INOP 


INOP 


INOP 


INOP 


INOP 


INOP 


INOP 


INOP 


INOP 


INOP 


INOP 


station| 
station| 


| 
| 


station| 
station| 
station| 


| 


station| 


station| 
| 
| 
station| 
| 
| 
station| 
station| 


station| 
| 


station 


station 


station 
station 


| 
| 
| 
| 
| 
| 
| 
| 
station| 
| 
| 
| 
| 
| 
| 
| 
| 
station| 
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RECORD MAINTENANCE STATISTICS MESSAGES 


RECMS messages are "Function Management Data" messages. More precisely, 
they belong to the "Physical Maintenance Services" and are identified 
by: 


| RH1 | RU 
| | 
es ee ee eee 
| / / | | | [X'O1'|X'03'|X'81" | / / | 
ee 
| 
Byte 0 | 
Bits 1, 2 <—— 
B'00' 


As far as X25NPSI is concerned, there are three types of Record 
Maintenance Statistics message: 


1. The RECMS for SNA link errors: Recording mode = X'72' 
2. The RECMS for SNA station errors: Recording mode = X'73' 


3. The RECMS for SNA statistics: Recording mode 


=X '76" 
TH1 RH1 | RU 
| 
—— SS ee ee ee ee 


| | | | | |Network Addr| Line | 
| | [X'O1'|X'03'|X'81'|of failing | Interface-—\ 
| | 


| | | | unit | Address | | 
| Lee ee ee Td Laem CRA Wena <a CEC 2 Sree ee eee ae Se Lek, eee eee eer ee | 
| 


| 
! | | | / | 
j 
cag [X"05' / of | 
| | | y yf | 


Recording Mode byte 


L_> X'72' = RECMS for SNA link errors 
X'73' = RECMS for SNA station errors 
X'76' = RECMS for SNA statistics 
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DESCRIPTION OF THE INTERNAL X25NPSI ERROR BYTES 


Internal X25NPSI Error Bytes for an MCH 


Should a failure occur on a MCH, X25NPSI maintains one byte in the MKB 
to explain this failure. When an MCH's RECMS for SNA link error has to 
be sent to the host, this byte is copied in place of LXBHSTAT. 


The format of this byte is: 


| : i 
{MKBMDREC | JACTION 
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{ 

FAILURE EXPLANATION \ 

{ 1X°02* No completion of XMIT action at level 2 {INOP link | 
{ | (Modem power OFF or level 2 ‘masked) { | 
{ 1x04" Permanent Synchro lost on receive leg JINOP link | 
| {x*05" wWN2 counter exhausted {INOP link ] 
| 1X*06" Scanner check: BError on final flag xrgission {INOP link | 
| | (CSB2 only) | | 
{ {1X°0O7" Modem check: {INOP link | 
{ | * DSR OFF due to permanent modem failure cr due to {| | 
| | LOOP test initialized by lccal network node. { | 
| { * CTS OFF in xnit. { | 
] 1x°O08* Carrier detector check {INOP link ( 
| 1x°09" Line permanently at mark {INOP link { 
{ IX'OA* Disconnect requested by DCE cr DM received {INOP station { 
{ { | jor link { 
{ 1X*OB* SABM received after setup (re-initialization {INOP station { 
; { not supported) | { 
| 1x*Oc* Unsolicited UA received |INOP station | 
| {xX‘OD* Unexpected "final bit" in a response {INOP station | 
\ {X°OE* Frame overrun (no LIQ available) {INOP link | 
{ 1x*10" CMDR sent for invalid length {INOP station ( 
| {x*11* CMDR sent for invalid N(R) {INOP station | 
| 1xX°13* Character underrun {INOP link | 
{ (x¢14* CMDR received (Invalid N(S)) {INOP station ] 
\ (X*15" CMDR received (W bit ON) {INOP station | 
] 1X°16" CMDR received (X bit ON) {INOP station { 
] 1X°17" CMDR received (Y bit ON) {INOP station { 
{ {xX°18* CMDR received (Z bit ON) | INOP station | 
| 1x°19" CMDR sent for invalid 'C* field {INOP station { 
| {1X*°1A* Maximum output gqueveing lisit reached {[INOP station | 
| | ! 
{ {ERROR CODES FOR UNSUCCESSFUL ENABLE/CCNTACT (CSE 2) | ( 
| | | { 
{ 1xX*80" Set mode X leg (CSB error) {INOP Link | 
{ {X*82* Set mode R leg (CSB error) {INOP link | 
| {x*84" DSR OFF on X leg (Line set error) {INOP link | 
{ {x*86" DSR OFF on R leg (modem fower off) {INOP link { 
{ 1X*8a*" Clock check (modem error) {INOP link | 
{ 1x*8Cc* DCE does not send flags {INOP Link ( 
{ { { ( 
| 1 | { 
| {ERROR CODES FOR UNSUCCESSFUL ENABLE/CONTACT (CSE 3) | | 
| { | { 
{ 1(x*92* Set mode X leg (CSB errcr) {INOP link { 
| (x*94" Set mode R leg (CSB error) 1INOP link ] 
{ 1X*96" DSR OFF on X leg (line set errer) {INOP link { 
| 1X°98* DSR OFF on R leg (modem rower cff) {INOP link { 
| IX°9A" RTS check (modem error) {INOP link ( 
{ 1X'9E* Clock check (modem error) {INOP link | 
| (X*AO* DCE does not send flags |INOP link { 
| {X*FF* Timeout on Restart Request J}INOP link | 
i iphone cll panini icles ni il lil ci i ci ls i alc it lS ii tes as a “i ai i a amp lon an | 


Internal X25NPSI Error Bytes for a VC 


Should an abnormal condition occur on a VC, X25NPSI maintains six bytes 
in the VCB to explain this condition. When a VC's RECMS for SNA 
link/station error or statistics is built, these six bytes are in the 
RECMS in place of the unused SDLC fields: 


VCBRECBO ----> LXBERST 
VCBRECB1 ----> LXBHSTAT 
VCBRECB2 ----> LXBEREST 
VCBRECB3 ----> SCBPCNT (Only in RECMS for SNA station error) 
VCBRECB4 ----> SCBNR (Only in RECMS for SNA station error) 
VCBRECB5 ----> SCBNS (Only in RECMS for SNA station error) 


The format of these six bytes is: 


| VCBRECBO | 

| | bit 0 Indicates that the RECMS applies to a VC 
| | | | 
| | bit 1 = 1 Indicates that the RECMS is generated by 
| | the X25NPSI 

| | a 

| | 

| | 

| | 

| | bits 2,3 

| VCBROMCH | 0O MCH failure 

| VCBROVCM | 01 VCM failure 

| VCBROPLP | 10 PLP failure 

| VCBROLLC | 11 LLC failure 

| | 

| | bits 4-7: indicate the category of the failure. 
| | Valid in case of VCM or LLC failure: 
| | 

| | In the case of VCM failure: 

| | 

| VCBROTO | 0001 Timeout 

| VCBROOCR | 0010 Outgoing call refused 

| VCBROCLE | 0011 Clear indication received 

| VCBRORET | 0100 Reset indication received 

| VCBRORAT | 0101 Restart indication received 

| VCBROICP | 0110 Invalid or unexpected control packet 

| | received 

| VCBROICR | 0111 Incoming call refused 

| | 

| | In the case of LLC failure: 

| | 

| VCBROPSH | 0001 PSH failure 

| VCBROPCO | 0010 PCNE O failure 

| VCBROLLD | 0100 LLC-OUT dispatcher failure 

| VCBROLLI | 0101 LLC-IN dispatcher failure 
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Wee et ee et oe ee OP ee a ee iy Re Pe a ee et ee 
| VCBRECB1 | | 


| In case of MCH failure (VCBRECBO bits 2,3=00): | 
VCBRIMCO | = X'00' | 


ooo 


In case of VCM failure (VCBRECBO bits 2-3=01) 


| 

| 

| 
| | | 
| | | 
| | | 
| | *For the "Type of failure’: Timeout | 
| VCBR1A01 | X'01' Timeout on CALL REQUEST | 
| | | 
| | *For the "Type of failure": Outgoing call refused | 
| VCBRIBO1 | X'01' LLC type invalid | 
| VCBR1BO2 | X'02' LLC type not supported | 
| VCBR1BO3 | X'03' Invalid VCCPT index | 
| VCBR1BO04 | X'04' Invalid OUFT index | 
| VCBR1BO5 | X'05' Slowdown during Connect-out | 
| VCBR1BO6 | X'06' Command refused due to MCH failure | 
| VCBR1BO7 | X'07' SVC not defined for CALL=OUT | 
| VCBR1BO8 | X'08' Calling or Called DTE address length invalid | 
| VCBR1BO9 | X'09' Invalid Dial Digits length | 
| | | 
| | *For the "Type of failure’: Clear indication received | 
| | The value of this byte is equal to the CAUSE byte | 
! . received in the CLEAR indication packet (1) | 
| 
| | *For the "Type of failure": Reset indication received | 
| | The value of this byte is equal to the CAUSE byte | 
! | received in the RESET indication packet (2) | 
| | 
! | *For the "Type of failure": Restart indication rcvd | 
| The value of this byte is equal to the CAUSE byte | 
| | received in the RESTART indication packet (3) | 
| | : | 
| | *For the "Type of failure": Invalid or unexpected | 
| | control packet received | | 
: | The value of this byte is equal to byte 0 of the packet | 
| header received | 
| | | 
| | *For the "Type of failure": Incoming call refused | 
| VCBR1CO1 | X'01' LLC type invalid | 
| VCBR1CO2 | X'02' LLC type not supported | 
| VCBR1CO3 | X'03' VC not in answer mode | 
| VCBR1C04 | X'04' VC defined with CALL=OUT only | 
| VCBR1CO05 | X'05' Contention with an outgoing call | 
| | 
| | In case of PLP failure (VCBRECBO bits 2,3=10) | 
| VCBR1PL1 | X'01' Invalid P(S) received | 
| VCBR1IPL2 | X'02' Q bit received, not supported | 


cede INCRE DS rena eer See oe ene COO tee Sacre Mee rie aie rae Pee el ee ENTE EY RENEE ee SN ae ET ae TOS eee eee 
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VCBRILL1 


VCBRILL2 


In case of LLC failure (VCBRECBO bits 2,3=11) 


*For an LLC-OUT dispatcher failure: 
X'01' LLU to be sent on an X.25 LVL3 state 
different from "Information Transfer" 
(P4) 


“For an LLC-IN dispatcher failure: 
X'02' Invalid input from End-User 


| 


VCBR1PS2 
VCBR1PS3 


VCBR1PS4 
VCBR1PS5 
VCBR1PS7 
VCBR1PS8 
VCBR1PS9 
VCBR1PSA 
VCBR1PSB 
VCBR1PC1 
VCBR1PC2 
VCBR1PC3 
VCBR1PC4 
VCBR1PC5 
VCBR1PC6 


VCBR1PC7 


VCBR1PC8 


*For a PSH failure: 
X'02' Invalid PU type in XID 
X'03' XID-LLU to sent on a PVC or on a state 
different from XMIT-XID 


X'04' Timeout and retries exhausted 

X'0S' Invalid NS-LLU received 

X'07' Invalid N(S) received in an I-LLU 

X'08' I-LLU to be sent on state different from 


PSH Data Transfer 

I-LLU received on state different from 
PSH Data Transfer 
X'OA' Contact request out of valid PSH state 
X'OB' 


x'o9' 


*For a PCNE failure: 

X'01' Error in inbound detected by LUSREQ: 
no SSCP-SLU session 

Error in inbound detected by LUSREQ: 
no PLU-SLU session 

Error in inbound detected by LUSREQ: 
SLU in RCV or FME-WAIT state 

Error in inbound detected by LUSREQ: 
SHUTC state entered | 

Error in inbound detected by LUSREQ: 
Wait for DFC response | 

Error in inbound detected by LUSREQ: 
no DFC request pending 

Error in inbound detected by LUSREQ: 
Begin bracket pending | 
X'08' Discontact processing on a PVC due to 

an ANS condition | 


X'02' 
X'03! 
X'04' 
X'05' 
X'06' 


x'o7' 


el 


Discontact request out of valid PSH state 


gE ey epee ee emer eee 
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(1) Cause byte in Clear: 


Xx'00' DTE clearing 

pa 8 Number busy (or CALL COLLISION) 

x03. Invalid facility request 

X'03' Invalid call (Network type 1) 

X'05' Network congestion 

X'05' Incidents on the network 
(Network type 1) 

x'09! Out-of-order 

X'OB' Access barred 

X'OD' Unknown number, not obtainable 

» aor Remote procedure error 

X'13' Local procedure error 

5! RPOA out of order 

X'19' Remote DTE refuses reverse charging 

x21" Incompatible destination 

X'21' End of out-of-order condition 


(Network type 1) 


(2) Cause byte in Reset: 


X'00' DTE resetting (Network type 1) 

X'00' End of out-of-order (Network type 2) 
X'O1' Out-of-order 

X'03' Remote procedure error 

X'05' Local procedure error 

X'07' Network congestion 

X'09' Remote DTE operational 

X'OF' Network operational 

X'11' Incompatible destination 


(3) Cause byte in Restart: 


x 00° DTE restart 

X'0O1' Local procedure error 

» Gal Os Network congestion 

x'05' End of out-of-order condition 
(Network type 1) 

x07" End of incidents on the network 


Network Type 1 is specified by coding NETTYPE=1 in the X25NET macro. 
Network Type 2 is specified by coding NETTYPE=2 in the XK25NET macro. 


When no network type is specified above, the cause is as defined 
in the CCITT-1980 X25 recommendations. 
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| VCBRECB2 


VCBR2MCO 


VCBR2VCO 


VCBR2PLO 


VCBR2LLO 


Note 1: 


| | 


| In case of MCH failure (VCBRECBO bits 2,3=00) | 
| = X'00' | 


In case of VCM failure (VCBRECBO bits 2,3=01) 


*For the "Type of failures": Timeout 
Outgoing call refused 
Incoming call refused 
= X'00' 


*For the "Type of failure": Clear indication received 
the value of this byte is equal to the DIAGNOSTIC 
byte received in the Clear indication packet (Note 1) 


*For the "Type of failure’: Reset indication received 
the value of this byte is equal to the DIAGNOSTIC 
byte received in the Reset indication packet (Note 1) 


*For the "Type of failure’: Restart indication rcvd 
the value of this byte is equal to the DIAGNOSTIC 
byte received in the Restart indication packet 


*For the "Type of failure’: Invalid or not supported 
control packet received, the value of this byte is 
equal to byte 2 of the packet header received 


| In case of PLP failure (VCBRECBO bits 2,3=10) | 
| = X'00' | 


| | 
| In case of LLC failure, (VCBRECBO bits 2,3=11) | 
| =X'00' | 


When the CAUSE byte means DTE clearing/resetting operation, the 
associated diagnostic byte should be read in accordance with the 
type of the remote DTE: 


1. If the remote DTE is a IBM 5973-L02 remote, you have to refer 
to IBM 5973-L02 Product Program Manual, GA11-8643 (SC7043) 


Section: 


Problem Determination - Aid 3. 


2. If the remote DTE is the X.25 NPSI program de itself, you 
have to refer to sections: 


Diagnostic field in the clear request packet for Type 1 networks 


Diagnostic field in the reset request packet. 
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For CAUSE values other than DTE clearing/resetting, see the X.25 network 
specifications corresponding to the PPSN you are using. 


fe pe ee eg eg 
| | VCBRECB3 This byte contains a copy of the VCM state at | 
| | the time of the failure: VCBVCMO | 
| | X'40' Inhibit transmit SARM | 
| | X'08' P6 - DTE CLEAR REQUEST in progress | 
| | X'04' P4 - Data transfer | 
| | x02" P2 - CALL REQUEST in progress | 
| | X'O1' D2 - DTE RESET REQUEST in progress | 
| | | 
| | VCBRECB4 This byte contains a copy of the PLP state | 
| | at the time of the failure: VCBEPST | 
| | X'80' DTE window closed | 
| | X'40' RNR received | 
| | x 20° Inbound packet accumulation in progress | 
| | X'10' PLP-IN locked for PCNE | 
J 

VCBRECB5 This byte contains a copy of the end user stat 


taken at the time of the failure 


*LLC dispatcher state = VCBEEST 


X'80' LLC timer running 
X'40' LLC-OUT waits for triggering 
X'20' LLC-IN timer elapsed 
*PSH state = VCBPSS1 
X'40' Waiting XID 
20" Waiting PSCONT 
x10 Waiting PSDISC 
X'08' Outbound segmenting 
X'04' Inbound segmenting 


*PCNE state = VCBEUS1 


ere ee RS ES RE ES SSD CEE REE eR ED EES ES ee Se ee ee ee ee 


| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| X'80' Information transfer | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 


X'80' Interrupt in progress 
X'40' SHUTC pending 
X'08' Inbound purge mode 


ee , | 
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RECMS FOR SNA LINK ERRORS 


The general format of RECMS for an SNA link error is: 


0 1 2 3 4 5 6 7 8 9 10 
fans a re See ee ae gee aes eee Gg ge ee 
| 01 | 03 | 81 | Network @ | Line | 82 | 05 | O1 | ........ 


| | | | of resource | intface| | | | 


| | | | | address | | | | 
ene Le | ee | Ran) eens eee eee! 


A A 
| | 
| 
| 


L—____First RU byte 


Recording mode byte-—————__ 


The purpose of an RECMS for SNA LINK error is to explain in detail the 
cause of a failure. 
MCH's RECMS for SNA Link Errors 


The MKBMDREC X25NPSI error byte explaining the failure is located in 
this RECMS. 


x'co'——————> LXBERST 
MKBMDREC > LXBHSTAT 


VC's RECMS for SNA Link Errors 
For a VC, the Line Interface Address is equal to X‘FCOO'. 


The VCBRECBO-2 X25NPSI error bytes explaining the abnormal condition, 
are located in this RECMS. 


VCBRECBO > LXBERST 
VCBRECB1 > LXBHSTAT 
> LXBEREST 


VCBRECB2 


RECMS FOR SNA STATION ERRORS 


The general format of an RECMS for an SNA station error is: 


0 1 2 3 4 5 6 7 8 9 10 

fe eh ee Og eee eee en ee RR sce ee Ae ees fet ere ee ee a 
| 01 | 03 | 81 | Network @ | line | 83 | 05 | O1 | ........ 

| | | | of resource | intface| | | | 

| | | | | address| | | | 

eer (cere: ene Neal i: 2 See Seren Cee eter) SEY rie ae er ee eee eNOS FAS eeE en (ne eeeee! 


A A 
| 
\____First RU byte | 

| 


Recording mode byte————___—_1 


The purpose of an RECMS for SNA station errors is: 
° To explain in detail the cause of the failure, and 


¢ To send to the CPU information concerning the activity of the 
corresponding station. 


An RECMS for SNA station errors must contain the information provided 


in: 
° An RECMS for SNA link errors, and 


e An RECMS for SNA statistics. 


MCH's RECMS for SNA Station Errors 
An MCH's RECMS.for SNA station errors contains the following bytes: 


x 'co '—————-> LXBERST 
MKBMDREC >LXBHSTAT 


and the eight standard statistics counters. 


VC's RECMS for SNA Station Errors 
For a VC, the Line Interface Address is equal to X'FCOO’. 


A VC's RECMS for SNA station errors contains the following bytes: 


VCBRECBO >LXBERST 
VCBRECB1 >LXBHSTAT 
VCBRECB2 >LXBEREST 
VCBRECB3 >SCBPCNT 
VCBRECB4 >SCBNR 
VCBRECB5 >SCBNS 
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And the 8 standard statistic counters. 


RECMS FOR SNA STATISTICS 


The general format of an RECMS for SNA statistics is: 


0 1 2 > 4 5 6. 7 8 9 10 
[rot eae eee are ep eg re eee a gee oe ge Qe ee et ape ee ae 
| 01 | 03 | 81 | Network @ | line Pee6 OS: FOL a) a charnare 


| | | | of resource | intface| | | | 


| | | | | address | | | | 
PN ee eeseaed 


A A 
| | 
| 
| 


L_——____First RU byte 


Recording mode byte————___! 


The purpose of an RECMS for SNA statistics is to send to the CPU 
information concerning the activity of the corresponding station. Note 
that in the case of an INOP LINK message, an RECMS for SNA statistics is 
generated for each station depending on this line. 


The standard NCP maintains 8 counters to give information about the 
traffic concerning this station. 


X25NPSI uses the same fields located in the SCB to maintain its own 
statistics. 
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MCH's RECMS for SNA Statistics 


In the case of an MCH, the standard fields for statistics are used by 


X25NPSI as follows: 


De ee pe ee Ee en pgp ee eg emery Bom gemn etre peace we eat ree eg ee ee ee ee 
| location | length | 


| in bytes | 


Jcsnsssnid) aR ctu ecco ia  aea aaa 


SCBTCNT 


| SCBTRTCT | 


| SCBRECNT | 


| SCBTPCNT | 


SCBRCNT 


| SCBRPCNT | 


SCBTIACT 


| SCBTINCT | 


2 


2 


2 


2 


2 


Meaning 


| Number of I Frames transmitted 


| Number of I Frames received 


| Number of RRs transmitted 


| Number of RRs received 


| lst byte: 
| 2nd byte: 
| 1st byte: 


| 2nd byte: 


Number of RNRs transmitted 

Number of RNRs received 

Number of REJs transmitted 

Number of REJs received 

Total number of retries on XMIT leg 


Number of frames received with 
FCS error 


| Total number of errors on receive leg 
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VC's RECMS for SNA Statistics 
For a VC, the Line Interface Address is equal to X'FCOO'. 


In the case of a VC, the standard fields for statistics are used by 
X25NPSI as follows: 


De ee ek eg ge ge ee a ee omy 


| Location | Length | Meaning 
| in bytes | : | 
| | | | 
| SCBTCNT | 2 | Number of I packets transmitted 
| SCBTRTCT | 2 | Number of I packets received 
| SCBRECNT | 2 | Number of RR packets transmitted 
| SCBTPCNT | 2 + | Number of RR packets received 


| SCBRCNT | 2 | lst byte: Number of RNR packets transmitted | 
| _a * | | 

| | | 2nd byte: Number of RNR packets received 

| SCBRPCNT | 2 | Number of interrupt packets transmitted 


| SCBTIACT | 2 | Total number of connection requests 
| (call request and incoming call) 


| SCBTINCT | 2 | Total number of connections 
| | (call connected/accepted) 


RECMS RETRIEVAL WITHOUT NETWORK COMMUNICATIONS CONTROL FACILITY (NCCF) 
The RECMS messages are eeconied on the: 

e SYSERR file under a VM system 

° SYS1.LOGREC, and possibly on NCCF file under an 0S/VS system 

° SYSREC file under a DOS/VS system. 


The purpose of this section is to indicate how to retrieve these records 
from these different files when not using the NCCF. 


RECMS Retrieval Under a VM System 


Refer to the IBM Virtual Machine Facility/370: OLTSEP and Error. 
Recording Guide, GC20-1809, and particularly to the section "Using the 
CPEREP Command". 
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Example: 


Enter first 


DEF STOR 1M 
I CMS 
CPEREP 


Once you have keyed the CPEREP command you may enter the following 
operands, via the prompting technique: 


ACC=N 
CUA=(addr) 
DATE=(yrday ) 
HIST=N 
PRINT=PS 


When you get the printout of the RECMS, it will contain formatted 
explanations concerning the nature of the failure. As far as X25NPSI is 
concerned, you do not have to take into consideration the edited 
information because the contents of the fields do not have the same 
meaning any more. Only the hexadecimal printing of the record is 
useful. 


RECMS Retrieval Under an OS/VS System 


Refer to the OS/VS Environmental Recording Editing and Printing (EREP) 
Program Manual, GC28-0772. 


Example: 


//STEP1 EXEC PGM=IFCEREP1, 
// PARM = ('ACC=N,TYPE=T,CUA=(addr) ,DATE=(yrday) , PRINT=PS' ) 


//SERLOG DD DSN=SYS1.LOGREC , DISP=OLD 
//TOURIST DD SYSOUT=A , DCB=BLKSI ZE=133 
//EREPPT DD SYSOUT=A , DCB=BLKSIZE=133 
//SYSIN DD DUMMY , DCB=BLKS I ZE=80 


When you get the printout of the MDRs and SDRs, it will contain 
formatted explanations concerning the nature of the failure. As far as 
X25NPSI is concerned, you should ignore the edited information because © 
the contents of the fields are no longer meaningful. Only the 
hexadecimal printing of the record is useful. 


RECMS Retrieval Under a DOS/VS System 


// JOB EREP 
// EXEC EREP 
OPTION CLEAR 
/* 

/& 
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TNL SN30-3213 (26 Feb 82) to SC30-3078-0 
Note: During the execution of this job, you may reply C to the 
following prompting: 


3E11D ENTER OPTION SOURCE, C=CARD, S=CONSOLE, N=NONE. 


RECMS RETRIEVAL WITH THE NETWORK COMMUNICATIONS CONTROL FACILITY (NCCF) 
The NCCF program product can be modified to edit the X25NPSI RECMS using 
the line interface address to identify them. The processing of such an 
RECMS by NPDA results in the printing of the hexadecimal configuration 
only. This is due to the fact that the RECMS is meaningless to NPDA. 


X25SNAP FACILITY 


The X25SNAP facility need not normally be used in an operational 
environment. 


In order to follow X25NPSI processing inside a 3705, a new macro 
instruction called X25SNAP has been developed. This X255NAP macro has 
been coded at key points of X25NPSI in level 3 and level 5 codes. It 
allows recording the following information in a wraparound storage area: 
. Identifier: Label of the X25SNAP macro (4 bytes) 

ad Registers 1 to 7 of the level (4 bytes): 


— The level is indicated in the first byte of register 1 


— The register identification is in the first half—byte of the 
second byte. 


- The register itself is in the 20 rightmost bits of these 4 
bytes. 


. 32 bytes of 3705 storage (optional). 

This information can be read when a dump of 3705 storage is made. 

This macro instruction can be very useful, but its use can be dangerous 
because the processing is very time-consuming. The possibility of 
overrun is rather high and depends on the number and speed of the lines 


connected to the 3705. 


When it is issued, the X25SNAP handler tests whether the SNAP area is 
included. If yes, it is executed. If not, the processing is bypassed. 
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| One of the following operations should be performed in order to activate 
the X25SNAP facility: 


1. Perform a system generation with SNAP=YES coded in the K25BUILD 
macro. 


Change the member coded in the "INCL2HI="" operand of the X25END 
macro of the MACLIB library, by including BALSTAS8 instead of 
BALSTAM8, and run the linkedit job. 


NO 


Including the X25SNAP Facility Under OS/VS 


Process an JEBUPDTE utility on your MACLIB. The following JCL may be 
used for this update on the sysgen example given above: 


//S81 EXEC PGM=IEBUPDTE 
//SYSPRINT DD SYSOUT=A 
//SYSUT1 DD DSN=SYS1.MAC71,DISP=SHR 
//SYSUT2 DD DSN=SYS1.MAC71,DISP=SHR 
//SYSIN DD * 
.{/ CHANGE NAME=DO1HII 
INCLUDE ULIB(BALSTAS8) 00012000 
./ ENDUP 


Including the X25SNAP Facility Under DOS/VSE 


With the Sysgen example given above: 

° Number the DOIHII book in the RL 

° List this book 

° Use MAINT utility to replace BALSTAM8 by BALSTASS8. 


To deactivate the SNAP facility, proceed with the reverse operations. 
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Editing and Interpreting the X25SNAP Trace 


To edit the trace produced by the X25SNAP macros, use the formatted 
dump. The trace area is dumped at each MCH occurrence in the formatted 
blocks. | 


The last entry filled is immediately followed by an entry flagged with 
FFFF as SNAP label. Going backwards, you may reconstitute the last 
events. 


Note: The entry at the end of the SNAP area flagged to FFFF is 
meaningful only when unique in the whole SNAP area. 


The structure of one entry in the SNAP area filled with registers is 
shown below: 
XXXXXXXX OLIRRRRR OO2RRRRR OO3RRRRR OO4RRRRR OOSRRRRR OO6RRRRR O0O7RRRRRR 


XXXXXXXX Is the SNAP identifier label of the X25SNAP macro in hexa. 
In the edited part of the dump it is the SNAP label in Char. 


L Is the level at which the X25SNAP has occured (3 or 5). 
1 to 7 Is the identification of the register.. 
RRRRR Is the value of the register at SNAP time. 


This entry is optionally followed by 32 bytes of storage taken at the 
Same time. 


The description of the significant register contents and of the optional 
32 bytes can be found in the assembly printouts using the following 
reference table: 


IN THE LLC DISPATCHERS (BALSTAM8 MODULE, BALLCIN CSECT): 


LCIO LLC-IN entry: R2=VCB address, R3=Buffer address, 
R7=PLP-IN return address 

LCIE LLC-IN after PCNE or PSH processing: R2=VCB address, 

Snap area=Buffer begin 
LCID LLC-IN exit: R2=VCB address 
LCIQ LLC-IN after ENQ on BNN: R2=VCB address, R3=Buffer address, 

R5=CUB address, Snap area=Buffer begin © 

LCIR LLC-IN inop: R2=VCB address, R3=Buffer address, snap area=Buffer begin 
LCOO LLC-OUT entry: R2=VCBQCB3 


IN LAP LEVEL 3: BALLAPZ3 CSECT: 

LPOO Enable: RiIHI=MKBLNKST, R2=Xmit UACB address, R5=MKB address 
LPO1 Disable: R1IHI=MKBLNKST, R2=Rcv UACB address, R5=MKB address 
LP10 XIO LINK: R3=Buffer address, R5=MKB address | 

LP60 Contact: R1HI=MKBLNKST, R2=Xmit UACB address, R5=MKB address 
LP70 Discontact: RIHI=MKBLNKST, R2=Rcv UACB address, R5=MKB address 
IN THE LU SIMULATOR (BALUSIMF): 


LRP1 LURSP Entry: R3=SLUB address, Snap area=SLUB 
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LRP2 LURSP Exit with error: R1=SLUB address, R2=PIU address 

LRP3 LURSP normal Exit: R1=SLUB address, R2=CUB address, R3=PIU address 

LRP5 LURSP normal Exit: R1I=SLUB address, R2=CUB address, R3=PIU address 

LRQ1 LUREQ Entry: R2=PIU address, R3=SLUB address, Snap area=SLUB 

LRQ2 LUREQ Exit with error: R2=PIU address, R3=SLUB address, Area=SLUB 

LRQ3 LUREQ normal Exit: R1=SLUB address, R2=CUB address, R3=PIU address 

| : Snap area=SLUB | 

LRQ& LUREQ normal Exit: R1=SLUB address, R2=CUB address, R3=PIU address 
Snap area=PIU 

LRV1 LUSRCV Entry: R2=PIU address, R3=SLUB address, Snap area=SLUB 

LRV2 LUSRCV Exit with error: R2=PIU address, R1I=SLUB address, Area=SLUB 

LRV3 LUSRCV normal exit: R2=PIU address, R3=SLUB address, Area=SLUB 


IN THE LINK LEVEL 2 TEST (BALL2TMB MODULE AND CSECT): 


L2I1 Inbound frame checking: R2=VCB address, R3=Received buffer address, 
R5=Packet type byte, R7=PH address 
L2I2 Test frame reformatting: R2=VCB address, R3=Received buffer address, 
R4=New buffer address 
L2I3 Frame received, error free: R2=VCB address, R5=TCB address 
L2I4 No data received: R2=VCB address, R3=Data count, 
R4=Received buffer address, R5=TCB address 
L2I5 Less data received: R2=VCB address, R4=Received buffer address, 
R5=TCB address 
L216 Data length discrepancy: R2=VCB address, R4=Received buffer address, 
R5=TCB address | 
L217 More data received: R2=VCB address, R4=Received buffer address, 
R5=TCB address 
L218 Data character invalid: R2=VCB address, R4=Received character address, 
R5=Sent character address 
L201 Timer elapsed entry: R2=VCB address, R3=LLC-OUT ECB address 
L202 LL2T activation: R2=VCB address, R4=TCB address, R5=VCBAT entry 
L203 Data length error: R1=Maximum packet length, R2=VCB address, 
R3=First buffer data count 
L204 Data length checking: Rl=Last TCB buffer length, R2=VCB address, 
R4=Last TCB buffer address 
L205 LL2 test end: R2=VCB address, R3=Frame request count, R4=TCB address, 
R5=Test ending state, R/7=Sent frame count 
L206 COPYPIU unsuccessful: R1=Return code, R2=VCB address, 
R7=Transmitted test frame count 
L207 Test frame building: R2=VCB address, R3=Test buffer address, 
R4=TCB address, R7=PH address 
L208 SARM inhibited state: R2=VCB address, R3=Test buffer address, 
R4=TCB address, R5=LLC-OUT QCB address 
L209 Release unused buffers: R2=VCB address, 
R3=Address of buffer to be released, 
R4=Previous buffer address 


IN THE NAS (BALNASM4 MODULE): 


NMI1 XIO IMMED to MCH: RIHI=LXBIMCTL, R2=UACB address, R3=LKB address 

NMK1 XIO LINK to MCH (XPARENT): R1HI=AVTSMK, R2=UACB add., R3=Buf add. 
R4=MKB address, R3=Xparent-out QCB, Area=Buffer 

NMK2 XIO LINK to MCH (from NCP Link L2 act.): RI=CUBSTATS, R2=UACB add. 
R3=Buf add., R4=CUB address, Snap Area=Buffer 

NMK3 XIO LINK to MCH (from NCP not lst. segment): R1I=CUBSTATS, R2=UACB addr. 


9=32 


NMK4 


NML1 
NMR1 
NVI1 
NVL1 


NVL2 


R3=Buf address, R4=CUB address, Snap Area=Buffer 
XIO LINK to MCH (from NCP, lst. segment): R1=CUBSTATS, R2=UACB address. 
R3=Buf address, R4=CUB address, Snap Area=Buf (—RESP) 
XIO LINE to MCH (Exit): R2=UACB address 
MCH unrecoverable error: R2=UACB address, R3=MKBATGFG, R4=MKBAT address 
XIO IMMED to VC: R2=UACB address (VUA) 
XIO LINE to VC: R2=UACB address, R3=LXBCMAND, R4=MKBAT address, 
-R5=QCB address 
R2=CUB address, R4=AVT address, R/7=MKBAT address 
R3=VCB address 


DISCONTACT VC, 
MCH not running: 


IN THE PCNE (BALPCNM9 MODULE AND CSECT): 


PAOC 


PAOE 
PAOM 
PAOP 


PAO4 
PAOS5 
PAO06 
PAO7 
PA13 
PA15 


PA17 
PA22 
PA32 


X25X1IO rej. for int. pkt: R1l=Return code, R2=VCB address, R4=Buf address 

R7=SLUB address 
R2=VCB address, R4=PIU 
R2=VCB address, R4=PIU 
Rl=return code, R2=VCB 
R7=SLUB address 
Out. proc. exit: Rl=ret. code, R2=VCB addr, 
Poll proc. exit: R2=VCB address, R7=LXBSTAT value 
SHUTC Req. to Host: R2=VCB addr, R4=SHUTC PIU addr, R7=SLUB addr 
Session Control Procedure entry: R2=VCB address, R4=PIU address 
Data Pkt Proc. exit: R2=VCB address, R3=SLUB address, R4=Buff address 
X25XIO rej. for int. conf.: R2=VCB addr, R3=SLUB addr, R4=Pkt addr 

| R5=PH in buffer 

Int. req. collision: R2=VCB address, R3=SLUB address 
XPARENT—IN: R3=MKB address, R4=PIU address, R5=CUB address 
XPARENT—OUT: R3=MKB address, R4=PIU address, R7=SLUB address 


address 
address 
addr, R4=buf addr, 


FMD procedure entry: 
DFC procedure entry: 
Int. conf. not rcvd: 


R4=PIU add, R7=SLUB addr 


IN THE PLP (BALPLPM5 MODULE AND CSECT): 


Ts 
PN3A 
PN4A 
PN4B 


PN4C 


In the Packet Dispatcher 


Inv. VCN Rev: 
Inv. VCN Xmit: 
Pseudo—Buffer release: 


Rl=1st. VCBAT addr, R2=lrst VCB addr, R5=MCH addr 
R2=VCB address, R5=Pkt VCN, R7=VCB VCN 

R2=VCB addr, R5=PLP/IN QCB, 

R7=Pseudo—Buffer address 


VCN validity check: R1=VCBAT entry, R2=VCB address 


In the PLP-IN 


Not Data Xfer state: R1=MKBATGFG, R2=VCB addr, R3=PH addr, R4=Buf addr 
R5=VCBATUID/VCBVCMO, R7=MKBAT address 

RNR Received: R1=RNR pkt type, R2=VCB address, R4=VCBAT entry 

LLC-—OUT wait trigger: R1=VCBEEST, R2=VCB address, R7=LLC—OUT QCB addr 

Inop from PLP: R2=VCB address, R7=VCBAT entry 

Inop from other layer: R2=VCB address 

Timer routine safe: R2=VCB address, R5=PLP—-IN QCB address, 
R7=PLP-IN ECB address 

Complete packet Received: R2=VCB address, R3=Buffer address, 

R7=PLP—-IN ECB address 
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oe 


PPOL 
PPO2 


In the PLP—OUT 


XIO LINK not executed: R2=VCB address, R3=Pkt address, Snap area=Pkt 
XIO LINK not executed (RR/RNR): R2=VCB addr, R3=Pkt addr, Snap area=Pkt 


IN THE PSH (BALPSHM7 MODULE): 


PSOR 


PSOX 


PSO3 


PSOI 


PSOT 


PSOY 


PSOG 


PSOS 
PSOV 
PSO5 
PS06 
PSO8 
PSO9 
PSOE 
PSOQ 
PSIA 


PSIL 


PSIX 


PSIC 


PSID 


PSH—OUT exit w/o action: Rl byte O=LLC state, R2=VCB address, 
R5=Active QCB address, R7 byte 1=PSH state, 
Rl byte 1=CUBSSCP 
PSH-OUT exit after process: R1i=Return code to LLC—OUT,. R2=VCB address, 
R3=Edited out buffer address, 
R5=Active QCB address 
Delayed contact wait issuance: R1=Return code to LLC—OUT, 
R2=VCB address, 
R5=Active QCB address 
PSH-OUT inop completed: R1=Return code to LLC-—OUT, R2=VCB address, 
R7 byte 1=Failure code, Snap area=VCB VCBVCMO 
PSH-—OUT timeout handler completed: R1 byte O=VCB state, 
R2=VCB address, R5=QCB address, 
Rl byte 1=PSH state 
Delayed contact wait re-issuance: Ri=Return code to LLC—OUT, 
R2=VCB address 
PSH data segmentation: R2=VCB address, R3=Copy buffer address, 
R5=Extra byte count, 
R7=Extra bytes origin address 
Data editor with segmentation: {R2=VCB addr,R3=PSH header buffer address 
{Snap area=PSH header buffer 
Data editor w/o segmentation: {R2=VCB addr,R3=PSH header buffer address 
{Snap area=PSH header buffer 
Discontact retry: Registers contents as for PSOX, 
Snap Area=Edited out buffer 
Discontact immediate end: Registers contents same as for PSOQ3 
Retry XID: Registers contents, dump area, same as for PSO5 
Retry contact: Registers contents, dump area, same as for PSO5 
Packet filled up: R1=PSH data length,R2=VCB address,R3=chain header 
R4=work chain tail,R5=chain count,R/7=chain tail 
Snap area=chain header buffer 
segmentation at buffer boundary: R2=VCB address,R3=PSH header buffer 
address 
PSH abandon connection completed: R2=VCB address, 
Snap area=VCB starting from VCBVCMO 
Terminal command dispatcher entry: R1 byte 1=Received PSH command, 
R3=Received buffer address, 
R5=PSH header address 
XID terminator completed: R1l=Return code to LLC-IN, R2=VCB address, 
R3=Received buffer address, 
R5=PSH header address 
Contact terminator completed: Rl=Return code to LLC-IN, R2=VCB address, 
R3=Received buffer address, 
R5=PSH header address 
Discontact terminator completed: R1l=Return code to LLC-—IN, 
R2=VCB address, 
R3=Received buffer address, 


R5=PSH header address 
PSII PSH-IN inoperative entry: Ri=Return code to LLC-IN, 
R2=VCB address, R7 byte 1=Failure code, 
Snap area=VCB starting from VCBVCMO 
PSI4 Terminal data unit validation entry: R1 byte 1=PSH state, 
R2=VCB address, 
R3=Received buffer address, 
Snap area=Received buffer 
PSIP Terminal data handler completed: R1=Return code to LLC-IN, 
R3=Buffer address (chain) ready to be | 
sent to the host (if any), 
Snap area=VCB starting from VCBVCMO 


IN THE VCM-IN ROUTINE (BALVCIMC MODULE AND CSECT): 

VIMC VCM-IN routine entry: 
R1HI=MKBATGFG ,R1LO=VCBATGFG,R2=VCB address, 
R3=Buffer address,R4=MKB address,R5=PKT2/PKT3, 
R7HI=PKT4 , R7 LO=VCBVCMO 

IN THE VCM-IN TASK (BALVCIM6 MODULE AND CSECT): 


VIM6 VCM-IN task entry: R1H1=MKBATGFG,R1LO=LKBSTATC ,R2=MKBQCB1 address, 
R3=Element address, R4=MKB address 


IN THE VCM-OUT TASK (BALVCOMA MODULE AND CSECT): 

VOF1 VCM-OUT entry: R1ILO=LXBCMAND,R2=VCB address ,R3=Element address, 
R4=MKB address,R5=VCBAT address ,R7HI=VCBATGFG, 
R7LO=VCBVCMO 

VOF2 XIO immediate: R1="'Switched ANS terminator" address ,R2=UACB address, 
R3=VCB address,R4=LKB address,RSHI=Request code, 
R7=NCP terminator address in the LKB 


VOF3 Inoperative routine: 


R2=VCB address,R4=VCBAT address ,R5LO=VCBRECBO, 
R7HI=VCBATGFG , R7 LO=VCBVCMO 


VOF4 Dial command: R1HI=MKBATGFG , RLLO=LXBCMAND ,R2=VCB address, 
R4=Dial digit address ,R/7LO=VCBTYPE 
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ABEND CODES 


Several abend codes have been programmed: 


No ECB on timeout (BALVCOMA) 
Invalid VCM state on an Activate link for a PVC (BALVCOMA) 
Wrong Interface at BALMAR1 Entry (BALVCOMA) 
Invalid VCM state on a timeout for an SVC (BALVCOMA ) 


COMMENTS | 


DISCREPANCY BETWEEN THE NCP AND X.25 SYSGEN (BALINIMD) 


NUMBER OF ERRORS SAVED IN THE MODULE AFTER THE LABELS 
ER1= MORE THAN ONE UACB FOR ONE LKB 
ER2= UACB NOT IDENTIFIED AS X.25 (MU OR VU) 
ER3= NCP/X.25 DISCREPANCY ABOUT SWITCHED/PERMANENT 
ER4= PU TYPE INVALID FOR LLCO, LLC1 (PU TYPE 1 ONLY 


INVALID VALUE IN MKBSTATC (BALVCIM6) 
NO ELEMENT ON QCB DURING RESTART PHASE (BALVCIM6) 
NO ELEMENT ON QCB WHEN MCH OPERATIONAL (BALVCIM6) 


INVALID VALUE IN LXBSTATC (BALVCIM6) 

INVALID VALUE IN CUBSSCP (BALVCIM6) 

INVALID COMMAND ON XIO LINE (LAP-LVL3) 
ENABLE ON A BUSY LINE (LAP-LVL3) 
CONTACT ON A LINE NOT ENABLED (LAP-LVL3) 
OVERRUN ON OPEN PHASES (OUT OF TABLE) (LAP-LVL3) 
DISCONT. ON A LINE ENABLE/DISABLE/ IDLE (LAP-LVL3) 
XIO SETMODE (LAP-LVL3) 
NO MORE A AND C FIELDS AT XMIT END (LAP-LVL3) 
INVALID NS RESPONSE FRAME AT XMIT END - (LAP-LVL3) 
INVALID S FRAME AT XMIT END (LAP-LVL3) 
INVALID NS COMMAND FRAME AT XMIT END (LAP-LVL3) 


NSA NOT ALLOWED IN ACTUAL GROWING PHASE (LAP-LVL3) 
TIMEOUT ON R-LEG NOT IN GROWING/DECREASING (LAP-LVL3) 
OR NOT WHEN PRIMARY AND SECONDARY IN ARM 

TIMEOUT ON R-LEG: INVALID AUX PRIMARY ON (LAP-LVL3) 
DECREASING 

TIMEOUT ON R-LEG: INV. AUX PRIMARY GROW. (LAP-LVL3) 
XMISSION SCHED: REQ. WHILE OUTQ COUNT=0 (LAP-LVL3) 


XMISSION SCHED: INVALID REQUEST (LAP-LVL3) 
FRAME ROUTER: FRAME PRES. LIQ NOT BUSY (LAP-LVL3) 
UNEXPECTED: SARM RECEIVED (LAP-LVL3) 
UNEXPECTED DISC RECEIVED (LAP) (LAP-LVL3) 
RCVD I FRAME: ERROR IN BUFFER CHAIN-CSB2 (LAP-LVL3) 
RCVD I FRAME: TOO SHORT (LAP-LVL3) 


NS RESP. RCVD IN A WRONG DECREAS. PHASE (LAP-LVL3) 
NSA RCVD WHILE NOT IN DECREASING/GROWIN (LAP-LVL3) 
NSA RCVD IN A WRONG GROWING PHASE (LAP-LVL3) 


ere eS GE CUEEND GEE GREENER CUE ES SS ES SE SR SN ES CES NS ES NS EN SS SS NS ES NS ES ES ES ES SS SS A ES NS ES SE SS SE NS SS ES mR 


COMMENTS 


REJ RECEIVED: WRONG N(R) CALCULATION 
WACK COUNT=0 WHILE PROCESSING N(R) 


CSB2 RCVD: NO MORE LIQ AVAILABLE 
LEVEL 3 NOT WORKING 
CBS2 RCVD: ERROR DETECTED — RGICW1 NO ERROR 


CSB3—XMIT INTERRUPT: 
NOT BUFFER SERVICE 
CSB3 XMIT ERROR 
CSB3 RECEIVED: NO MORE LIQ AVAILABLE 
LEVEL 3 NOT WORKING 


MODULO OTHER THAN 8 (NOT SUPPORTED) 


INVALID BUFFER OR PSEUDO—BUFFER ON X25XIO 
LT.3 OR GT.FRMLGTH 


INVALID PACKET LENGTH: 
LINE TIMER LEVEL 3 FOR A VC 


DEQUEUE INVALID DURING RESET SYSTEM TIMER 


X25XIO INTERFACE ERROR 


THE X25NPSI ISSUED XIO LINK INSTEAD OF X25XI0O 


X25EXTRA INTERFACE ERROR 


LEVEL 3 INTERRUPT FOR A VC 
LEVEL 2 INTERRUPT FOR A VC 


ERROR IN LUSRCV 
ERROR IN LUSRSP 
ERROR IN LUSREQ 


DISPATCH—OUT FUNCTION NOT RECOGNIZED 
PHYSICAL SERVICES ERROR 

UNKNOWN SESSION CONTROL COMMAND 
INVALID ENTRY IN THE TIMER ROUTINE 
DISPATCH-IN FUNCTION NOT RECOGNIZED 
NO PIU QUEUED IN TRANSPARENT MODE 


VC NUMBER DISCREPANCY IN VCB AND PKT 
OTHER THAN CONTROL PACKET RECEIVED 

INVALID PVC STATUS, PROGRAMMING ERROR 
INVALID SVC STATUS, PROGRAMMING ERROR 


X25NPSI MODULES 


The X25NPSI modules are: 


BALLAPN1 LVL2 LAP for CSB2 and CSB3 
BALLAPN2 LVL2 LAP for CSB2 
BALLAPN3 LVL2 LAP for CSB3 
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NOT XMIT END AND 


(LAP-LVL3 ) 
(LAP—LVL3 ) 
(LAP—-LVL2 ) 


(LAP-LVL2 ) 
(LAP-LVL2 ) 


(LAP—-LVL2) 
(LAP-LVL3) 
(LAP-LVL3) 


(BALPLPMS5 ) 


(BALNASMG ) 
(BALNASM4 ) 
(BALNASMG4 ) 
(BALNASMG ) 
(BALNASMG ) 


(BALNASM4 ) 


(BALNASM4 ) 


(BALNASME ) 
(BALNASME ) 


(BALUS IMF) 


(BALUS IMF) 
(BALUS IMF) 


(BALPCNM9 ) 
(BALPCNMQ ) 
(BALPCNM9 ) 
(BALPCNM9 ) 
(BALPCNM9 ) 
(BALPCNMQ ) 


(BALVCIMC ) 
(BALVCIMC ) 
(BALVCIMC ) 
(BALVCIMC ) 
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BALLAPM1 
BALLAPM2 
BALLAPM3 
BALNASM4 
BALPLPM5 
BALVCIM6 
BALPSHM7 
BALSTAM8 


BALSTAS8 


BALPCNM9 
BALVCOMA 
BALL2TMB 
BALVCIMC 
BALINIMD 
BALNASME 
BALUS IMF 


LVL3 LAP for CSB2 and CSB3 
LVL3 LAP for CSB2 

LVL3 LAP for CSB3 

NAS Level 3/4/5 

PLP 

VCM-IN Task 

PSH 

Common Routines: 


— Block Dump Tables 
— LLC—-OUT Task Dispatcher 


— LLC-—-IN Routine Dispatcher 


Common Routines, same as BALSTAM8 plus: 
— Snap Area 


PCNE & Transparent 
VCM—OUT 

Link Level 2 Test 

VCM—-IN Routine 
Initialization Routine 
NAS Level 2/3 in low core 
Logical Unit Simulator 


EXAMPLE OF ASSEMBLY FOR X25NPSI MODULES UNDER OS/VS 


//S81 EXEC | PGM=CWAX0OO, PARM='DECK,XREF (SHORT) ,NOALOGIC ,SYSPARM(OS) ' 
//STEPLIB DD DSN=SYS1.SSPLIB,DISP=SHR 

//SYSPRINT DD SYSOUT=A 

//SYSUT1 DD UNIT=SYSDA , SPACE=(1700, (800,800) ) , DCB=(OPTCD=C) 
//SYSUT2 DD UNIT=SYSDA, SPACE=(1700, (800,800) ) ,DCB=(OPTCD=C) 
//SYSUT3 DD UNIT=SYSDA , SPACE=(1700, (800,800) ) ,DCB=(OPTCD=C) 
//SYSLIB DD DSN=SYS1.RPQSRC , DISP=SHR 

// DD DSN=SYS1.MAC3705X,DISP=SHR 

// DD DSN=SYS1.MAC3705 ,DISP=SHR _ 

//SYSPUNCH DD DSN=&&O0BJSET , UNIT=SYSSQ , SPACE=(80, (600) ) ,DISP=(, PASS) 
//SYSIN DD DSN=SYS1.RPQSRC (BALxxxxx) , DISP=SHR 

//LKED EXEC PGM=IEWL, PARM=(XREF, LET, LIST,NCAL) 

//SYSPRINT DD SYSOUT=A 

//SYSLIN DD DSN=&&OBJSET , DISP=(OLD , DELETE ) 

//SYSLMOD DD DSN=SYS1.0BJ3705X(BALXXXXX) , DISP=OLD 

//SYSUT1 DD UNIT=SYSDA, SPACE=(1700, (800,800) ) ,DCB=(OPTCD=C) , DISP=OLD 


Where BALxxxxx stands for the names specified above. 


Note: 


When assembling the "BALDSECT" member, remove the linkedit step. 


EXAMPLE OF ASSEMBLY FOR X25NPSI MODULES UNDER DOS/VSE 


// JOB ASM BALxxxxx 

// ASSGN SYSPCH, 280 

// MTC REW,280 

// OPTION DECK 

// EXEC IFZASM 
PUNCH '// JOB CATALR BALxxxxx ' 
PUNCH '// EXEC MAINT 

END 
/ ve 


// OPTION DECK,NOXREF | 
// EXEC IFZASM 

COPY BALXxxxx 

END 

/ ve 

// MTC WITM,SYSPCH 

// CLOSE SYSPCH,UA 

/& 


Where BALxxxxx stands for the names specified above. 
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STORAGE 


The basic X25NPSI code requires a minimum of 
35 Kbytes of storage in addition to that for 


distributed as follows: 


The 


Init routine 

NAS Low Core 

NAS High Core 

VCM-OUT 

VCM-IN 

VCM-Common 

PLP 

PSH 

LLC/BDT or 

LLC /BDT/SNAP 

LAC with CS2 Lvl2 

LAC with CS2 Lv13 

LAC with CS3 Lvl2 

LAC with CS3 Lv13 

LAC with CS2/CS3 Lvl2 
LAC with CS2/CS3 Lv13 
PCNE 

LUSIM 

LL2T/VC 


(BALINIMD) 
(BALNASME ) 
(BALNASMG ) 
(BALVCOMA) 
(BALVCIMC) 
(BALVCIM6) 
(BALPLPM5 ) 
(BALPSHM7) 
(BALSTAMB ) 
(BALSTAS8) 
(BALLAPN2) 
(BALLAPM2 ) 
(BALLAPN3) 
(BALLAPM3 ) 
(BALLAPN1) 
(BALLAPM1) 
(BALPCNN9 ) 
(BALUSIMF ) 
(BALL2TMB ) 


STORAGE AND PERFORMANCE 


100 
2600 
2900 
3100 
1600 
2500 
2100 
1000 
3900 
1300 
5600 
1300 
5600 
2200 
5900 
4000 
2250 
1600 


X25NPSI uses several new control blocks: 


AVT 
MKBAT 
MKB 

MUA 
VCGAT 
VCBAT 
VCB 

VUA 
SLUB 
VCCPTIT 
OUFTIT 
YCCPT 
OUFT | 


28 bytes 

8 + 12*] 
176 

116 

8 + 12%m 

8 + 12*n 
204 

108 

38 

8 + 4*(pt1) 
8 + 4*(qt1) 
14* (pt+1) 

8 + q*(4*f + u) 


25 Kbytes and a maximum of 
the prerequisite ACF/NCP, 


850 (overriden by buffers) 


per 3705 


= number of multichannel links 


per multichannel link 
per multichannel link 


= number of logical channel groups 
= number of virtual circuits 


virtual circuit 
virtual circuit 


per 
per 


per 
per 
per 
per 
per 


virtual circuit, LLC=0 


network, p 
network, q 


network 
network, f 


u 


higher VCCPT index 
higher OUFT index 


number of facilities 
user data length 
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PERFORMANCE 


The environment assumptions for the values given in this section are: 


On outgoing PIUs, the only performance consideration is the addi- 
tional cycles between (1) the KIO link from BNN Path Control—Out and 
(2) the scheduling of the frames for transmission. 


The actual sending and receiving of data has similar 3705 cycle use 
as the SDLC procedure, without non-productive polling. 


On incoming PIUs, the only performance consideration is the addi- 
tional cycles between (1) the end-of-frame received and (2) the 
scheduling of the BNN Path Control-In delayed. Consider the follow- 
ing: : 


1. First Case, using SNA to SNA communications: 


Suppose the PIU (segment) to be transmitted or received can 
be contained in only one packet. The PIU must be 2 bytes 
less than the packet size because the LLC header is 2 bytes 
long. 


Additional cycles include 2000 cycles for each PIU OUT plus 
900 cycles for each "Receive Ready " received, and 3100 
cycles for each PIU IN plus 1300 cycles for each "Receive 
Ready" sent to the network. 


2. Second Case, using SNA to SNA communications: 


Suppose the PIU (segment) contains 256 bytes of data, with a 
maximum packet length of 128 and a buffer size of 100 bytes. 
This PIU (segment) must be sent or received in three 
packets. 


Additional cycles include 6800 cycles to transform the out- 
going PIU (segment) into three packets, plus 900 cycles for 
each "Receive Ready’ packet received from the network. 


7300 cycles are used, on the receiving side, to receive the 
three packets and combine them into one PIU (segment) plus 
3900 cycles to build and send three "Receive Ready" packets. 


3. Third case, using SNA to non-SNA communications with the PCNE 
(SNA/X.25 Protocol Converter): 


Suppose the data unit is contained in one packet. On the 
SNA side, the RU length would equal the packet length. 
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Additional cycles include 2800 cycles for each data unit OUT 
plus 900 cycles for each "Receive Ready" packet received, 
and 3600 cycles for each data unit IN plus 1300 cycles for 
each "Receive Ready" sent. 


4. Fourth case, using SNA to non-SNA communications with the PCNE 
(SNA/X.25 Protocol Converter): 


Suppose the data unit contains 384 bytes, with a maximum 
packet length of 128. The data unit must be contained in 
three packets. 


Additional cycles include 7600 cycles to transform the out- 
going PIU into three packets, plus 900 cycles for each "Re- 
ceive Ready " packet received from the network. 


7800 cycles are used, on the receiving side, to combine the 


three packets into one PIU plus 3900 cycles to send three 
"Receive Ready’ packets. 
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CCITT 
CMDTE 
CUD 


D 


DACTLU 
DATE 
DCE 
DFC 
DTE 
DTR 


| rj 


FCS 
FID 
FIC 
FMD 


1q2 


GATE 
GTF 


=o 


HDLC 


LIST OF ACRONYMS 


Advanced Communications Facility 
Activate Logical Unit 


Begin Bracket 

Begin Bracket Pending 
Between Brackets 
Boundary Network Node 


International Telegraph and Telephone Consultative Committee 


Character Mode DTE 
Call User Data field 


De-activate Logical Unit 

Dedicated Access to X.25 Transport Extension 
Data Circuit Equipment 

Data Flow Control 

Data Terminal Equipment 

Data Terminal Ready 


Frame Checking Sequence 
Format Identifier 

First In Chain 

Function Management Data 


General Access to X.25 Transport Extension 
Generalized Trace Facility 


High Level Data Link Control 
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INB 
INN 
ISO 
I-LLU 


In Bracket 

Inter Network Node | 
International Organization for Standardization 
Information Logical Link Unit 


Line Access Control (X.25 Level 2 in X.25 NCP Packet Switching 
Interface) 

Line Access Protocol 

Line Access Protocol Balanced 
Logical Channel Group Number 
Logical Channel Number 

Last In Chain 

Link Input Queue 

Logical Link Control 

Logical Link Unit 

Line Vector Table 

Logical Unit Simulator 


Multi Channel Link 

More Data Bit 

Middle In Chain 

Maintain System History Program 


Network Action Scheduler (X. 25 Packet Sue en tne Interface Layer) 
Network Control Program 

Network Extension Option 

Network Interface Adapter 

Network Performance Analyzer 


Only In Chain 

Single Segment 

Online Line Test : 
Optional User Facility Table 


Packet Assembly De-assembly 

Protocol Converter for Non-SNA Equipment 

Path Information Unit 

Packet Level Logical Interface 

Packet Level Procedure (X.25 Packet Switching Tieereacs Layer) 


PLU 
PMDTE 
PPSN 
PSH 
PSN 
PVC 
PU 


UACB 
ULVT 


V 


VCB 
VCBAT 
VCCPTIT 
VCGAT 
VCM 

VCN 
VPACING 


X 


A25PSI 


Primary Logical Unit 

Packet Mode Data Terminal Equipment 

Public Packet Switching Network 

Physical Services Header (X.25 Level 4 for SNA Terminals) 
Packet Switching Network 

Permanent Virtual Circuit 

Physical Unit 


Record Maintenance Statistic 
Rejected Message (Packet or Frame) 
Receive Not Ready 


Receive 
Request 


Ready 
Unit 


Set Asynchronous Balanced Mode 
Start Data Traffic 
Shutdown Complete 


Shutdown 


Secondary Logical Unit 
System Maintenance Program 
Systems Network Architecture 
Switched Virtual Circuit 


Transmission Header 


User Adapter Control Block 
User Line Vector Table 


Virtual 
Virtual 
Virtual 
Virtual 
Virtual 
Virtual 


Circuit 
Circuit 
Circuit 
Circuit 
Circuit 
Circuit 


VTAM Pacing 


Block 

Block Address Table 

Connection Parameter Table Index Table 

Group Address Table 
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